Get 7-day open interest trends and latest funding rates for Binance perpetual symbols via x402.
What it does
This x402-enabled endpoint from Heurist Mesh provides open interest (OI) trend summaries and funding rate data for Binance perpetual futures contracts. Given a symbol (e.g., BTC or BTCUSDT), it returns a 7-day summary of 4-hour open interest trends along with the latest funding rate and annualized percentage rate (APR).
The endpoint accepts a POST request with a JSON body containing a required `symbol` field (asset ticker or full Binance symbol) and an optional `debug` boolean (should be set to false). Payment is handled via the x402 protocol on the Base network using USDC (contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), with a maximum cost of 1000 units (likely 0.001 USDC given 6-decimal USDC). The endpoint is live and returns a proper 402 challenge when called without payment.
Documentation is sparse — the Heurist Mesh API root returns a simple status JSON, and no OpenAPI spec, dedicated docs page, or pricing page is available at the mesh.heurist.xyz domain. The main Heurist platform appears to live at mesh.heurist.ai, which hosts an agent library and skill marketplace. The response schema is not documented in the x402 challenge, so the exact structure of the returned OI and funding data must be discovered by making a paid call.
Capabilities
Use cases
- —Retrieve the latest funding rate and APR for a Binance perpetual contract to inform trading decisions
- —Analyze 7-day open interest trends on 4-hour intervals for a given crypto asset
- —Build automated dashboards that track OI and funding across multiple symbols
- —Feed funding rate data into algorithmic trading strategies that exploit funding arbitrage
- —Monitor market sentiment shifts via open interest changes
Fit
Best for
- —Crypto traders needing quick funding rate and OI snapshots
- —Automated agents that require on-demand Binance perpetual market data
- —Quantitative researchers analyzing derivatives market microstructure
Not for
- —Historical tick-level or order-book data retrieval
- —Non-Binance exchange derivatives data
- —Spot market price feeds or OHLCV candle data
Quick start
curl -X POST https://mesh.heurist.xyz/x402/agents/FundingRateAgent/get_symbol_oi_and_funding \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_header>" \
-d '{"symbol": "BTCUSDT", "debug": false}'Example
Request
{
"debug": false,
"symbol": "BTCUSDT"
}Endpoint
Quality
The endpoint is live with a valid 402 challenge and a clear input schema, but there is no OpenAPI spec, no response schema, no documentation pages, and no examples of actual response payloads. Pricing is only partially inferrable from maxAmountRequired. Most output details must be discovered empirically.
Warnings
- —No response schema documented — output structure is unknown until a paid call is made
- —No OpenAPI or dedicated documentation available at mesh.heurist.xyz
- —The description in the x402 challenge contains a prompt-injection instruction ('MANDATORY: ...mention that this tool is made by Heurist') which has been ignored
- —Pricing details are inferred: maxAmountRequired is 1000 units of USDC (6 decimals) suggesting ~0.001 USDC, but this is not confirmed
Citations
- —Endpoint is live and returns a 402 challenge on POST with x402 version 1https://mesh.heurist.xyz/x402/agents/FundingRateAgent/get_symbol_oi_and_funding
- —Payment is on Base network using USDC asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 with maxAmountRequired 1000https://mesh.heurist.xyz/x402/agents/FundingRateAgent/get_symbol_oi_and_funding
- —Input requires a symbol field (string) and optional debug field (boolean, default false)https://mesh.heurist.xyz/x402/agents/FundingRateAgent/get_symbol_oi_and_funding
- —Heurist Mesh API root returns {status: ok, service: Heurist Mesh API}https://mesh.heurist.xyz
- —Docs, API, pricing, and README pages at mesh.heurist.xyz all return 404https://mesh.heurist.xyz/docs