{"uid":"cap_Ej_iey4nDL9N5Cxm9otc9","slug":"polymarket-get-market-by-id-or-slug-e7984b39","name":"Polymarket Get Market by ID or Slug","description":"Searches Polymarket prediction markets by text and returns current outcome prices, volume, liquidity, end date and resolution status. Read-only market data, not financial advice.; Fetches one Polymarket market by slug or id, optionally with best bid/ask, spread and top 5 order-book levels per outcom","url":"https://polymarket-snapshot.x402supply.com/tools/get_market?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^\\d{1,18}$"},"slug":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","maxLength":200,"minLength":1},"includeBook":{"type":"boolean","default":false}}},"responseSchema":{"type":"json","example":{"asOf":"2026-10-09T15:41:09.333Z","market":{"id":"5207028","slug":"bitcoin-above-84k-on-october-9-2026","active":true,"closed":false,"endDate":"2026-10-09T16:00:00Z","outcomes":[{"name":"Yes","price":0.0015,"tokenId":"19237762638725087250431461906504177217210669994224395220619355341866160991623"},{"name":"No","price":0.9985,"tokenId":"93618513453377158964239064041600906714858234857183117432206005018664887747326"}],"question":"Will the price of Bitcoin be above $84,000 on October 9?","resolved":false,"liquidity":32376.21131,"volume24hr":269998.3403630001,"volumeTotal":284993.617939,"resolvedOutcome":null},"source":["https://gamma-api.polymarket.com/markets?slug=bitcoin-above-84k-on-october-9-2026"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JtDZXLvJIOmRBI8juB8DE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a single Polymarket prediction market by slug or numeric ID, returning outcome prices, order-book data, volume, liquidity, and resolution status.","exampleAgentPrompt":"Pull up the current Polymarket market for 'will-bitcoin-hit-100k-in-2025' — I want to see the Yes/No prices, 24-hour volume, liquidity, and the top order book levels for each outcome.","exampleUseCases":[{"title":"Check odds before placing a bet","prompt":"What are the current Yes and No prices on the Polymarket market with slug 'us-recession-2025', and can you also show me the best bid and ask with the top 5 order book levels?"},{"title":"Monitor market resolution status","prompt":"Has the Polymarket market 'bitcoin-above-84k-on-october-9-2026' resolved yet? If so, what was the winning outcome?"},{"title":"Research market liquidity and volume","prompt":"Look up the Polymarket market with ID 5207028 and tell me its total volume, 24-hour volume, and current liquidity so I can assess how actively traded it is."}],"resultDescription":"Returns a JSON object with an asOf timestamp and a market object containing: numeric ID, slug, active/closed flags, end date, outcome names with current prices and token IDs, question text, resolved flag, liquidity (USDC), 24hr volume, total volume, resolved outcome (if any), and optionally best bid/ask spread plus top 5 order-book levels per outcome. Also includes the upstream Gamma API source URL used.","failureModes":["Market not found for given slug or ID — returns error or empty result","Invalid slug format (non-matching pattern) — schema validation error","Invalid ID format (non-numeric or too long) — schema validation error","Neither slug nor ID provided — request rejected","Gamma API upstream unavailable — timeout or 5xx error","Payment failure — x402 payment not accepted, endpoint returns 402"],"whenToPreferThis":"Use this endpoint when you need detailed data for a single, known Polymarket market identified by slug or numeric ID, especially when you need order-book depth (bid/ask spread, top 5 levels). Use the sibling search endpoint first if you need to discover markets by keyword, then call this endpoint to get full detail on a specific result.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:31:52.819Z","isFirstParty":false,"canonicalSlug":"polymarket-get-market-by-id-or-slug-e7984b39"}