{"uid":"cap_tUdveZkJYb9kZGJi-s_kx","slug":"blockrun-perpetual-contract-snapshot-88e9c73b","name":"BlockRun Perpetual Contract Snapshot","description":"Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.","url":"https://blockrun.ai/api/v1/surf/exchange/perp","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"pair":{"type":"string","description":"Required query param"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0085","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0085/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ubaa1Y-fnPpYE-1Om1SQ4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a snapshot of perpetual contract data for a specified trading pair from a cryptocurrency exchange.","exampleAgentPrompt":"Can you pull the current perpetual contract snapshot for BTC-USDT from BlockRun, including funding rate and mark price?","exampleUseCases":null,"resultDescription":"A snapshot of perpetual contract data for the specified trading pair, likely including mark price, index price, funding rate, open interest, and other relevant contract state fields at the time of the call.","failureModes":["Missing or invalid 'pair' query parameter returns an error","Unsupported or misspelled trading pair symbol returns no data or error","Exchange data temporarily unavailable causes timeout or 5xx error","Payment not settled (x402) results in 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need a real-time or near-real-time snapshot of perpetual contract state (funding rate, mark price, open interest) for a specific trading pair, and you want pay-per-call access without managing API keys. Prefer this over OHLCV endpoints when you need live contract-level derivatives data rather than historical candlestick data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:51:07.272Z","isFirstParty":false}