---
title: "Perp Funding Implied Yield"
method: POST
path: "/v1/tools/compute_perp_funding_implied_yield"
tags: ["TODO_TAGS_REVIEW"]
---

# Perp Funding Implied Yield

`POST /v1/tools/compute_perp_funding_implied_yield`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/compute_perp_funding_implied_yield`
- Auth: none declared

Recomputes a perpetual-contract funding rate and its simple-annualized implied yield from caller-declared inputs, for either of two declared funding-mechanism variants: offshore-8h-twap (a continuous TWAP-sampled premium-index-plus-interest-rate-differential-clamp formula, the shape observed on offshore crypto perpetual venues) or kalshi-periodic (a simpler point-in-time price-differential reset, modeled against the CFTC's 2026 regulated-perpetual-contract framework). The funding mechanism, and every numeric parameter of it (interval length, clamp bound), is always a declared input, never an assumed default. An optional prev_funding_hash chains this print to its predecessor's own execution_hash, turning a series of same-pair prints into a walkable, cryptographically bound funding history. Complements the landed Prediction Market Artifact Validator (T631) in copy only, with no file overlap: that tool validates settlement artifacts for event markets, this one recomputes the ongoing funding-rate carry on a perpetual position. Verify-only: recomputes a caller-declared formula from caller-declared inputs, never fetches a live market price or a venue's actual current funding print, and never asserts that any venue's own published print matches this recompute. A declared input outside the domain (invalid mechanism, non-positive price, malformed prior-print hash, etc.) is rejected by name, never silently clamped or coerced.

**Tool URL:** https://ainumbers.co/chaingraph/art-654-perp-funding-implied-yield.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `clamp_pct` number, required: Percentage value
  - `funding_mechanism` unknown, required
  - `index_price` number, required
  - `interest_rate_pct` number, required: Percentage value
  - `interval_hours` number, required
  - `mark_price` number, required
  - `position_notional` number, required
  - `position_side` unknown, required
  - `premium_index_pct` number, required: Percentage value
  - `prev_funding_hash` unknown, required
  - `venue` unknown, required

## Response `200`

Successful tool execution result

- object
  - `chained` false | true, required
  - `clamp_pct` number, nullable
  - `disclaimer` string
  - `domain_errors` string[], required
  - `funding_mechanism` string, nullable, required
  - `funding_payment` number, nullable, required
  - `funding_payment_direction` string, nullable, required
  - `funding_rate_pct` number, nullable, required
  - `implied_annual_funding_yield_pct` number, nullable, required
  - `index_price` number
  - `interest_rate_pct` number
  - `interval_hours` number, required
  - `mark_price` number
  - `mechanism_note` string
  - `periods_per_year` number, nullable, required
  - `position_notional` number
  - `position_side` 'long' | 'short', required
  - `premium_index_pct` number
  - `prev_funding_hash` string, nullable, required
  - `scope_note` string, required
  - `sign_convention_note` string
  - `venue` string, nullable, required

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)