Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint
$ man funding-rates

/funding-rates(1)

agentutility / edge-market / funding-rates
PRICE / CALL
$0.002
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarket
CATEGORY
uncategorized
STATUS
live
NAME
funding-rates perp funding rates / binance usd-m futures funding / next-funding-time / 24h history / perp basis
SYNOPSIS
POST https://x402.org/v1/funding-rates
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Perp funding rates / Binance USD-M futures funding / next-funding-time / 24h history / perp basis. Current funding %, mark + index price, next funding timestamp, and last 24 funding intervals (default 24 × 1h-since-event) for any Binance USD-M futures symbol (BTCUSDT, ETHUSDT, SOLUSDT…). Free public Binance API — no auth.

INPUTrequest schema
propertytypedescriptionreq?
symbolstringBinance futures symbol — uppercase, no slash. e.g. 'BTCUSDT', 'ETHUSDT'.required
history_intervalsnumberHow many past funding events to include. Range [1, 48]. Default 24.optional
OUTPUTresponse shape
fieldtypedescription
symbolstringBinance USD-M futures symbol queried (e.g. BTCUSDT, ETHUSDT, SOLUSDT).
mark_pricestringCurrent mark price used for funding and PnL calculations on the perp contract.
index_pricestringSpot index price the perp tracks, used as the funding-rate reference.
current_funding_rate_pctstringCurrent funding rate as a percent (positive = longs pay shorts, negative = shorts pay longs).
next_funding_atstringISO timestamp when the next funding payment settles on this perp.
last_24h_avg_pctstringMean funding rate percent across the last 24 hourly funding intervals.
last_24h_max_abs_pctstringLargest absolute funding rate percent seen in the last 24 funding intervals.
historystringArray of the last 24 funding intervals with rate percent and settlement timestamp per entry.
sourcestringUpstream data provider, here Binance USD-M futures public API.
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/funding-rates \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the funding-rates tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
funding-ratesperp-fundingbinance-futuresperp-basismark-pricenext-funding-timederivativesusd-m-futures
methods
POST
cluster
edgemarket
price
$0.002 USDC per call
ADJACENTother endpoints in edgemarket
endpointdescriptionprice
erc20-balanceERC-20 balance reader / balanceOf / on-chain token balance / wallet balance lookup / multi-chain ERC20 balance / read Base / read Ethereu…$0.002
erc20-metadataERC-20 metadata reader / token info / token symbol lookup / token decimals / total supply / multi-chain ERC20 reader / Base / Ethereum /…$0.002
safe-tx-decodeGnosis Safe execTransaction decoder.$0.003
agent-card-resolveAgent card resolver / ERC-8004 Identity Registry lookup / Trustless Agents / agentId → owner + agentURI / A2A identity / agent.json fetch…$0.005
arbitrage-spreadCross-exchange arbitrage spread / max-min price / CEX price dispersion / spread % calculator.$0.005
basename-resolveBasename resolver / Coinbase Basenames / .base.eth lookup / Base name service / on-chain name resolution.$0.005
defi-yield-poolsDeFi yield pools / APY aggregator / yield-farming opportunities / DeFiLlama yields / cross-protocol APY ranking / stablecoin yields / LP…$0.005
ipfs-fetchIPFS fetch / IPFS gateway / Web3 storage retrieval / NFT metadata fetcher / Filecoin gateway / decentralized content / pinned-content reader.$0.005
SEE ALSO
agentutility(7) · edgemarket(7) · x402(7) · mcp(7) · llms.txt · registry.json · bazaar.x402.org