{"openapi":"3.1.0","info":{"title":"Agent Desk API","version":"0.6.0","description":"Machine-payable crypto market data for agents (deskfeed.dev). Calls are settled per request in USDC on Base via x402 (HTTP 402). Descriptive market data for informational purposes only. Not financial advice."},"servers":[{"url":"https://deskfeed.dev"}],"paths":{"/v1/market-state":{"get":{"operationId":"market-state","summary":"Agent Desk API: Market State","description":"Multi-timeframe market state for BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT & DOGEUSDT USD-M perpetual futures in one call: mark & index price, funding rate, open interest change, taker buy share, per-timeframe (4h/1h/15m) EMA-20/50, RSI-14, ATR and prior 20-bar high/low. Structured for trading agents needing clean market context. Descriptive data only — not financial advice. Refreshed every 15 min; data age disclosed in every response.","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string","enum":["BTCUSDT","ETHUSDT","SOLUSDT","XRPUSDT","DOGEUSDT","ALL"],"default":"BTCUSDT"},"description":"Futures symbol; ALL returns every covered symbol"}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402 challenge in PAYMENT-REQUIRED header)"}},"x-x402":{"scheme":"exact","price":"$0.01","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetName":"USDC","note":"Payment requirements are authoritative in the live 402 response."}}},"/v1/events":{"get":{"operationId":"event-facts","summary":"Agent Desk API: Event Facts","description":"Verified market-moving events for crypto agents: headlines categorized (liquidations, macro, regulation and more) and tagged to BTC/ETH, each with source, publisher, timestamp, original link, and a trust tier distinguishing primary official sources from aggregated headlines. Filter by symbol, category, and count. Fresh every 15 minutes.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":"Max events to return"},{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"Filter events by symbol, e.g. BTCUSDT"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by category (e.g. LIQUIDATION, MACRO, REGULATION)"}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402 challenge in PAYMENT-REQUIRED header)"}},"x-x402":{"scheme":"exact","price":"$0.005","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetName":"USDC","note":"Payment requirements are authoritative in the live 402 response."}}},"/v1/bsc-alerts":{"get":{"operationId":"bsc-alerts","summary":"Agent Desk API: BSC Alerts","description":"Volume-anomaly observations across newly created BSC pools, from a 15-minute monitoring sweep: pools whose hourly volume spiked vs the prior hour (floor $1,000 and 100x), with pool name, hourly volume, spike ratio, price move and source link. Machine-readable monitoring feed for agents tracking early on-chain activity. Observation data only — thresholds uncalibrated; not signals, not financial advice. Refreshed every 15 minutes; data age disclosed in every response.","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":"Max alerts to return (newest first)"},{"name":"window_hours","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":168,"default":24},"description":"Look-back window in hours"}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402 challenge in PAYMENT-REQUIRED header)"}},"x-x402":{"scheme":"exact","price":"$0.005","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetName":"USDC","note":"Payment requirements are authoritative in the live 402 response."}}},"/v1/bsc-verdict":{"get":{"operationId":"bsc-verdict","summary":"Agent Desk API: BSC Verdict","description":"BSC token risk verdict in one call: send a BSC token address, get a 0-100 score, A-F grade, a plain-language take, key risk facts (honeypot, taxes, liquidity, holder concentration, mint/ownership flags) and a shareable card link. Security flags from GoPlus, honeypot simulation from honeypot.is, market data from DexScreener. Descriptive data only — not financial advice. Live per request.","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"BSC token contract address (0x + 40 hex characters)"}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402 challenge in PAYMENT-REQUIRED header)"}},"x-x402":{"scheme":"exact","price":"$0.02","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetName":"USDC","note":"Payment requirements are authoritative in the live 402 response."}}},"/v1/bsc-pool-autopsy":{"get":{"operationId":"bsc-pool-autopsy","summary":"Agent Desk API: BSC Pool Autopsy","description":"BSC pool autopsy in one call: pool age, liquidity, 1h/24h volume and transaction spike ratios, buy/sell pressure, holder concentration, LP lock, honeypot/tax/mint/ownership flags, and a 0-100 risk verdict with grade. Built from DexScreener, GoPlus and honeypot.is. Accepts a BSC pool/pair address (token addresses resolve to the largest BSC pair). Descriptive on-chain data only — not financial advice.","parameters":[{"name":"pool","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"BSC pool/pair address (0x + 40 hex); token addresses resolve to the largest BSC pair"},{"name":"window_hours","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":168,"default":24},"description":"Observation window in hours (1, 6 or 24 map to DexScreener windows; >24 uses 24h)"}],"responses":{"200":{"description":"Paid response","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required (x402 challenge in PAYMENT-REQUIRED header)"}},"x-x402":{"scheme":"exact","price":"$0.02","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetName":"USDC","note":"Payment requirements are authoritative in the live 402 response."}}}}}