{"slug":"agentshelf-syntexa-ch-v1-perp-funding-rates-08d8c2","title":"Call when an agent needs current perpetual funding for one symbol or a fixed maj","host":"agentshelf.syntexa.ch","method":"POST","resource":"https://agentshelf.syntexa.ch/v1/perp-funding-rates","category":"code","description":"Call when an agent needs current perpetual funding for one symbol or a fixed major list. Tries Hyperliquid and Binance USDT-M futures, then OKX and Bybit. Includes next funding time and mark or index when the venue returns them. A geo-blocked venue is skipped. Send JSON {\"symbol\":\"BTC\"}. Exact $0.00","price_listed":0.002,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"symbol":"BTC"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"examples":[{"symbol":"BTC"}],"properties":{"limit":{"default":10,"description":"How many majors to return when symbol is omitted. Example: 2. Default 10. At most 10. Ignored when symbol is set.","maximum":10,"minimum":1,"type":"integer"},"symbol":{"description":"Perpetual base asset. Example: BTC. BTCUSDT and BTC-USDT are accepted. Omit it for the fixed major list, not a volume ranking.","examples":["BTC"],"type":"string"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"examples":[{"billed":true,"limit":1,"ok":true,"rates":[{"funding_rate":"0.0000125","index_price":"81776.0","interval_hours":1,"mark_price":"81772.0","market":"BTC","next_funding_time":1792742400,"symbol":"BTC","venue":"hyperliquid"},{"funding_rate":"0.0000863256263960","index_price":"81760.6","interval_hours":8,"mark_price":"81727.6","market":"BTC-USDT-SWAP","next_funding_time":1792742400,"symbol":"BTC","venue":"okx"}],"receipt_id":"rcpt_01EXAMPLE000000000000000","sources":["hyperliquid","okx"],"symbol":"BTC","warnings":[]}],"properties":{"billed":{"examples":[true],"type":"boolean"},"limit":{"examples":[1],"exclusiveMinimum":0,"maximum":10,"type":"integer"},"ok":{"const":true,"examples":[true],"type":"boolean"},"rates":{"examples":[[{"funding_rate":"0.0000125","index_price":"81776.0","interval_hours":1,"mark_price":"81772.0","market":"BTC","next_funding_time":1792742400,"symbol":"BTC","venue":"hyperliquid"},{"funding_rate":"0.0000863256263960","index_price":"81760.6","interval_hours":8,"mark_price":"81727.6","market":"BTC-USDT-SWAP","next_funding_time":1792742400,"symbol":"BTC","venue":"okx"}]],"items":{"additionalProperties":false,"properties":{"funding_rate":{"type":"string"},"index_price":{"type":["string","null"]},"interval_hours":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}]},"mark_price":{"type":["string","null"]},"market":{"type":"string"},"next_funding_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"symbol":{"type":"string"},"venue":{"enum":["hyperliquid","binance","okx","bybit"],"type":"string"}},"required":["venue","symbol","market","funding_rate","next_funding_time","mark_price","index_price","interval_hours"],"type":"object"},"maxItems":80,"type":"array"},"receipt_id":{"examples":["rcpt_01EXAMPLE000000000000000"],"type":"string"},"sources":{"examples":[["hyperliquid","okx"]],"items":{"enum":["hyperliquid","binance","okx","bybit"],"type":"string"},"maxItems":4,"type":"array"},"symbol":{"examples":["BTC"],"type":["string","null"]},"warnings":{"default":[],"examples":[[]],"items":{"type":"string"},"type":"array"}},"required":["ok","receipt_id","billed","symbol","limit","rates","sources"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Call when an agent needs current perpetual funding for one symbol or a fixed major list. Tries Hyperliquid and Binance USDT-M futures, then OKX and Bybit. Includes next funding time and mark or index when the venue returns them. A geo-blocked venue is skipped. Send JSON {\"symbol\":\"BTC\"}. Exact $0.002 USDC on Base. Try unpaid POST /v1/sandbox/perp-funding-rates first.","last_updated":"2026-10-23T07:45:25.234Z","schemes":["exact"]}