{"uid":"cap__mqyEw3oApAYMuRWja73X","slug":"scanna-open-interest-08e49da4","name":"Scanna Open Interest","description":"Open interest in USD. Omit market_id for the platform-wide aggregate, or pass a Polymarket condition id (0x + 64 hex) to scope it to one market. Anything else - empty, whitespace, a repeated or bracketed parameter, or the literal GLOBAL - is 400, not silently answered as an aggregate. A well-formed id upstream does not know is 404, never an empty 200. 60-second shared cache; a stale read is disclosed on X-Data-Freshness and still served.","url":"https://api.scanna.xyz/open-interest","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"market_id":{"type":"string","pattern":"^0[xX][0-9a-fA-F]{64}$","description":"Polymarket condition id. OMIT for the platform-wide aggregate. A value that is not a condition id is 400 — including the literal GLOBAL, which upstream uses to label its own aggregate row."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["open_interest_usd","market_id"],"properties":{"market_id":{"type":["string","null"],"description":"The condition id this figure describes, echoed back. NULL means the platform-wide aggregate — a scoped request always echoes its own id, never null."},"open_interest_usd":{"type":"number","description":"Open interest in USD"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.010016","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.010016/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010016","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010016","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6xXbogxsx1wA-4F9ASXBp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.010016","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Polymarket open interest in USD, either platform-wide or scoped to a single market by its condition ID","exampleAgentPrompt":"What's the current total open interest across all of Polymarket right now, and can you also tell me the open interest specifically for the market with condition ID 0x4bec3c72f4abe4f4f73df38d8eae37ad5b30b95a211b29df0e6b2e49ba87e3c4?","exampleUseCases":[{"title":"Monitor platform-wide prediction market liquidity","prompt":"What is the total open interest across all markets on Polymarket right now? I want to see how much capital is at stake platform-wide."},{"title":"Size a specific market before trading","prompt":"Before I place a trade, can you tell me the open interest in USD for the Polymarket market with condition ID 0x3b6d88e62d9a0e54c14c9d5c6e3bb16e8f8e61b2a3c7f4a2e9d1b5c8a7f2e3d1?"},{"title":"Track open interest trends for a single market","prompt":"Keep an eye on the open interest for Polymarket condition 0x9a3f12c8b7e2d5a1f4c6e8b2d9a7f3e1c5b8d2a4f6e9c1b3d7a5f8e2c4b6d9a0 and let me know if it changes significantly."}],"resultDescription":"A JSON object containing open_interest_usd (a number representing total open interest in USD) and market_id (null for platform-wide aggregate, or the echoed condition ID for a scoped request). The response also includes an X-Data-Freshness header indicating whether data is fresh or served from the 60-second shared cache.","failureModes":["400 Bad Request: market_id provided but not a valid 0x + 64 hex Polymarket condition ID (e.g. passing 'GLOBAL', whitespace, or malformed IDs)","404 Not Found: well-formed condition ID supplied but not recognized by upstream Polymarket data","Stale data: response served from 60-second cache, disclosed via X-Data-Freshness header","Upstream unavailability causing propagation delays or errors"],"whenToPreferThis":"Use this endpoint when you need Polymarket open interest figures — either platform-wide or per-market — with clear error semantics (400 for bad input, 404 for unknown valid IDs, never a silent empty 200). Prefer it over scraping Polymarket directly when you need structured USD open interest data with caching and error transparency. It is purpose-built for Polymarket condition IDs and will not silently accept ambiguous inputs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:32:24.191Z","isFirstParty":false}