Cobo Agentic Wallet
Back to Recipes
Polymarket Research Polygon

Polymarket Research Polygon

Query Polymarket off-chain APIs for market discovery, odds retrieval, and order book depth — read-only, no on-chain transaction required. Use before `polymarket-trading-polygon` to fetch metadata and identify exchange type.

CategoryPrediction Markets
ChainsMATIC
C
Cobo· Author
102 views·1 uses

Overview

Query Polymarket off-chain APIs for market discovery, odds retrieval, and order book depth — read-only, no on-chain transaction required. Use before polymarket-trading-polygon to fetch metadata and identify exchange type.

Facts

•api.gamma: https://gamma-api.polymarket.com/markets
•api.clob: https://clob.polymarket.com
•CLOB chain_id for mainnet: 137

Typical Flows

Market discovery:

1.GET https://gamma-api.polymarket.com/markets — query active markets; note conditionId, neg_risk flag
2.Identify exchange type from neg_risk field: false → CTF Exchange; true → Neg Risk CTF Exchange

Odds & order book:

1.GET https://clob.polymarket.com/book?token_id=<tokenID> — order book depth and bid/ask
2.Confirm market open; check liquidity for intended bet size before trading

Policy Controls

•Odds change between fetch and execution: Re-fetch immediately before trading; never cache odds.
•`neg_risk` flag determines exchange: Routing error causes revert; always read from market metadata.
•API rate limits: Implement backoff; no authenticated rate is ~100 req/min.
•No pact — all logic is agent-side: Thresholds, filters, and decision rules are entirely agent's responsibility.
•Not applicable for: order placement or redemption — use polymarket-trading-polygon and polymarket-settlement-polygon respectively
•Partial reference: use web search for unlisted tokens, contracts, parameters, or up-to-date addresses

References

•Docs: https://docs.polymarket.com/llms.txt — CLOB order types, CTF/neg-risk exchange contracts, conditional token redemption, USDC.e collateral.