{"slug":"perp-gap-api-perpgap-workers-dev-funding-791955","title":"Use when an agent must pick the cheapest venue to hold a stock perp or size fund","host":"perp-gap-api.perpgap.workers.dev","method":"GET","resource":"https://perp-gap-api.perpgap.workers.dev/funding","category":"market","description":"Use when an agent must pick the cheapest venue to hold a stock perp or size funding carry. Funding on trade.xyz, Aster, Lighter and OKX normalized to hourly and annualized APR, interval and next funding time, cheapest venue to be long or short, carry spread, optional 24h/7d/30d history; one ticker o","price_listed":0.02,"price_asked":0.02,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":47,"reported_calls_30d":2,"reported_payers_30d":1,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"history":"7d","ticker":"NVDA"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"additionalProperties":false,"properties":{"history":{"description":"Optional history window (single ticker).","enum":["24h","7d","30d"],"type":"string"},"min_spread_apr":{"description":"Board only: minimum venue APR spread in pp.","pattern":"^[0-9.]+$","type":"string"},"ticker":{"description":"Stock ticker, case-insensitive (free list: GET /catalog).","examples":["NVDA"],"pattern":"^[A-Za-z0-9.]{1,12}$","type":"string"},"tickers":{"description":"Optional alternative to ticker: 'all' for the full board.","enum":["all"],"type":"string"}},"required":["ticker"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"description":"Error responses are JSON {error: string, hint?: string}. 400 bad params (never charged); 402 payment required; 404 ticker/market not listed (checked before settlement, never charged); 502 upstream error. Full field docs: /openapi.json.","properties":{"as_of":{"type":"string"},"history":{"type":"object"},"sign":{"type":"string"},"summary":{"type":"object"},"ticker":{"type":"string"},"us_session":{"type":"string"},"venues":{"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.02,"price_match":true,"latency_ms":47,"error":null}],"description_full":"Use when an agent must pick the cheapest venue to hold a stock perp or size funding carry. Funding on trade.xyz, Aster, Lighter and OKX normalized to hourly and annualized APR, interval and next funding time, cheapest venue to be long or short, carry spread, optional 24h/7d/30d history; one ticker or tickers=all. Bad params return 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.","last_updated":"2026-10-22T21:53:06.268Z","schemes":["exact"]}