{"uid":"cap_uhTxH2dTudyRidH5v2ANy","slug":"aisa-mpp-data-apis-polymarket-spread-c4bd0f7d","name":"Polymarket Spread","description":"Retrieves the spread for a specific token ID. The spread is the difference between the best ask and best bid prices.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/polymarket/spread?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["token_id"],"properties":{"token_id":{"type":"string","description":"Token ID (asset ID)"}}},"responseSchema":{"type":"object","required":["spread"],"properties":{"spread":{"type":"string","example":"0.02","description":"Spread as a string"}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.012/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YnQKBC99RnnT0eUXlRt-W","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Retrieves the bid-ask spread for a specific Polymarket prediction market token by token ID.","exampleAgentPrompt":"What's the current bid-ask spread on Polymarket for token ID 71321050856746154452989188028916814621541765919547968739073706498304195102590?","exampleUseCases":[{"title":"Check liquidity before placing a bet","prompt":"Before I buy into this Polymarket prediction market, can you check the spread for token ID 71321050856746154452989188028916814621541765919547968739073706498304195102590 so I know how wide the bid-ask is?"},{"title":"Monitor spread tightness for arbitrage","prompt":"Can you pull the current spread for Polymarket token 52114319501245915516055106046884209969926127482827954674443846427813813222426 — I want to see if it's tight enough to make an arbitrage trade worthwhile?"},{"title":"Compare market efficiency across tokens","prompt":"Get me the bid-ask spread for Polymarket token ID 16678291189211314787145083999015737376658799626183230671758641503291735614088 — I'm trying to assess how efficiently this market is priced."}],"resultDescription":"Returns a JSON object containing the spread as a string (e.g. '0.02'), representing the difference between the best ask and best bid prices for the specified Polymarket token.","failureModes":["Invalid or non-existent token_id returns an error response","Missing required token_id parameter results in a 400 bad request","Network timeout if Polymarket orderbook data is temporarily unavailable","Token with no active orderbook may return a zero or null spread","Rate limiting or payment failure may block the request"],"whenToPreferThis":"Use this endpoint when you need the current bid-ask spread for a specific Polymarket prediction market token and want a lightweight, single-field response. Prefer this over fetching full orderbook data when only the spread metric is needed for liquidity assessment, trading decisions, or market efficiency analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:54.682Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-spread-c4bd0f7d"}