Skip to content
onelayer.
All tools

Tool detail

Perp funding rate and history

Funding-rate snapshot and history for one perpetual futures market: current hourly/8h/annualized rate, mark-vs-oracle premium, and a window of past prints with average, min, max and percent positive.

Categories: Market prices

Use when

  • check the current funding rate before opening a leveraged perp position
  • see whether a perp's funding regime just flipped
  • get funding-rate history for a coin's perpetual market

Not for

  • not spot price or order-book data
  • not multi-market screening — one coin per call

Inputs

POST JSON body: coin (string, required, e.g. BTC/ETH/SOL); limit (number, optional, hourly points, default 24, max 500).

Admitted input schema

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Perp ticker, e.g. BTC, ETH, SOL (case-insensitive)."
    },
    "limit": {
      "type": "number",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Hourly history points to return (default 24, max 500)."
    }
  },
  "required": [
    "coin"
  ],
  "additionalProperties": false
}

Endpoint

Method
POST
URL
https://agent402.tools/api/perp-funding

Payment

Protocol
x402
Listed price
0.002 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
POST https://agent402.tools/api/perp-funding
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z