{"uid":"cap_GLdh19tuwhgkQHl9xD1HH","slug":"polymarket-markets-lookup-via-gamma-api-8b6c27cf","name":"Polymarket Markets Lookup via Gamma API","description":"Call when an agent needs Polymarket markets from the public Gamma API, with outcomes, prices, decimal odds, volume, liquidity, and end date. Optional search, tag, limit, active, and closed. Send JSON {\"tag\":\"bitcoin\",\"limit\":1,\"active\":true,\"closed\":false}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/polymarket-markets first.","url":"https://agentshelf.syntexa.ch/v1/polymarket-markets?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tag":{"type":"string","pattern":"^[A-Za-z0-9-]{1,40}$","examples":["bitcoin"],"description":"Polymarket tag slug or numeric tag id. Example: bitcoin. Resolved through gamma-api.polymarket.com. Omit it for no tag filter."},"limit":{"type":"integer","default":10,"maximum":20,"minimum":1,"examples":[1],"description":"How many markets to return. Example: 1. Default 10. At most 20. Ordered by volume when Gamma provides it."},"active":{"type":"boolean","default":true,"examples":[true],"description":"When true, keep markets Gamma marks active. Example: true. Omit it for the default, which is active markets only."},"closed":{"type":"boolean","default":false,"examples":[false],"description":"When true, keep markets Gamma marks closed. Example: false. Omit it to leave closed markets out."},"search":{"type":"string","pattern":"^[^#&?]{2,80}$","maxLength":80,"minLength":2,"description":"Search text for the public Gamma API. Example: bitcoin. Omit it to list markets without a text query."}}},"responseSchema":null,"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_SmpabR9alWR31XmU7eA0Q","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 Polymarket prediction markets with outcomes, prices, decimal odds, volume, liquidity, and end date via the public Gamma API","exampleAgentPrompt":"Pull up the top 5 active Polymarket markets tagged 'bitcoin' — I want to see the current prices, odds, volume, and end dates for each.","exampleUseCases":[{"title":"Track crypto prediction market odds","prompt":"What are the top 3 active Polymarket markets about Ethereum right now? Show me the outcomes, current prices, and trading volume."},{"title":"Research election prediction markets","prompt":"Find me up to 10 active Polymarket markets related to elections — I want the odds, liquidity, and when each one closes."},{"title":"Audit recently closed markets","prompt":"Give me 5 closed Polymarket markets tagged 'politics' so I can see how the final prices resolved and what the volume was."}],"resultDescription":"Returns a list of Polymarket markets matching the filters, each with market name, possible outcomes, current prices, decimal odds, total trading volume, liquidity, and end date as provided by the Gamma API.","failureModes":["Invalid or unknown tag slug returns empty results or error","Limit exceeds maximum of 20 returns validation error","Search text under 2 characters or containing special characters (#, &, ?) is rejected","Gamma API unavailable causes upstream timeout or error response","Payment of exactly $0.005 USDC on Base required; underpayment returns 402","Conflicting active/closed flags may return empty result sets"],"whenToPreferThis":"Use this endpoint when an agent needs structured Polymarket prediction market data including odds, prices, volume, and liquidity without building direct Gamma API integration. Ideal for agents that need filtered market lists by topic tag or keyword search. Prefer this over direct Gamma API calls when x402 micropayment-based access is already in use and the sandbox endpoint has been validated first.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:47:58.560Z","isFirstParty":false,"canonicalSlug":"polymarket-markets-lookup-via-gamma-api-8b6c27cf"}