{"uid":"cap_GlRphlCi7MrWkXwxrW4VN","slug":"api-nansen-ai-9cd4804c","name":"Nansen Prediction Market Orderbook","description":"Get Prediction Market Orderbook","url":"https://api.nansen.ai/api/v1/prediction-market/orderbook","method":"GET","headers":{},"bodySchema":{"type":"object","title":"OrderbookRequest","required":["market_id"],"properties":{"market_id":{"type":"string","title":"Market Id","examples":["654412"],"maxLength":100,"minLength":1,"description":"Polymarket market ID"},"pagination":{"type":"object","title":"PaginationRequest","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Page number (1-based)"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page (max 1000)"}},"description":"Pagination parameters for API requests."}},"description":"Request for orderbook endpoint.","additionalProperties":false},"responseSchema":{"type":"object","title":"OrderbookResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"OrderbookLevel","required":["market_id"],"properties":{"side":{"anyOf":[{"type":"string"}],"title":"Side","examples":["buy"],"description":"buy or sell"},"size":{"anyOf":[{"type":"number"}],"title":"Size","examples":[1000],"description":"Size at level"},"price":{"anyOf":[{"type":"number"}],"title":"Price","examples":[0.52],"description":"Price level"},"outcome":{"anyOf":[{"type":"string"}],"title":"Outcome","examples":["Yes"],"description":"Outcome label"},"asset_id":{"anyOf":[{"type":"string"}],"title":"Asset Id","examples":["71321045679252212"],"description":"CLOB token ID"},"event_id":{"anyOf":[{"type":"string"}],"title":"Event Id","description":"Event ID"},"market_id":{"type":"string","title":"Market Id","examples":["654412"],"description":"Market ID"},"outcome_index":{"anyOf":[{"type":"integer"}],"title":"Outcome Index","examples":[1],"description":"Outcome index"},"cumulative_size":{"anyOf":[{"type":"number"}],"title":"Cumulative Size","examples":[5000],"description":"Cumulative size"},"snapshot_timestamp":{"anyOf":[{"type":"string","format":"date-time"}],"title":"Snapshot Timestamp","examples":["2024-11-01T12:00:00"],"description":"Snapshot timestamp"}},"description":"Orderbook level from ch_api_pm_orderbook."},"title":"Data","description":"List of orderbook level records"},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response for orderbook endpoint."},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KjYh_ENAREvN3pPh5uynL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the current orderbook for a specified prediction market, showing bids and asks with depth and pricing data.","exampleAgentPrompt":"Pull the current Nansen orderbook for the prediction market on the next Fed rate decision — show me all the bids and asks with their price levels and sizes.","exampleUseCases":null,"resultDescription":"Returns the full orderbook for the specified prediction market, including bid and ask orders with price levels, quantities, and depth data, sourced from Nansen's on-chain smart money analytics.","failureModes":["Invalid or unknown market identifier returns 404 or empty result","Market not yet tracked by Nansen returns no data","Malformed POST body returns 400 validation error","Rate limit exceeded returns 429","Payment not provided or insufficient returns 402"],"whenToPreferThis":"Use this endpoint when you need real-time orderbook depth and open order data for a specific prediction market, especially when you want Nansen's smart money labeling context. Prefer over generic DEX APIs when you need wallet-labeled order attribution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:30:37.138Z","isFirstParty":false}