Summary
Beyond the 5 endpoints tracked in #438, Polymarket's CLOB API has added 15+ additional endpoints that are not in core/specs/polymarket-clob.yaml. These cover tick-size configuration, negative-risk market handling, fee-rate queries, sampling markets, and simplified market views.
Impact
MEDIUM — these endpoints represent significant new API surface. Without them in the spec, PMXT cannot use callApi() to access them, and missing tick-size/fee-rate data may cause incorrect order construction.
Details
Missing endpoint groups:
- Tick size:
GET /tick-size — returns tick size per market condition ID; needed for correct price rounding
- Negative risk:
GET /neg-risk, POST /neg-risk/convert — neg-risk market metadata and position conversion
- Fee rate:
GET /fee-rate — current taker/maker fee rates for the authenticated address
- Sampling markets:
GET /sampling-markets, GET /sampling-simplified-markets — reduced market sets for sampling use cases
- Simplified markets:
GET /simplified-markets — condensed market list with fewer fields, for performance
- Market book snapshots:
GET /books (batch) — multi-market orderbook snapshot in one call
- Midpoint prices:
GET /midpoints — batch midpoint prices for multiple condition IDs
- Spread:
GET /spread, GET /spreads — current bid/ask spread data
- Price history:
GET /prices-history — OHLCV-style price history per market
- Additional order management:
GET /orders (batch status check by array of order IDs)
Required Fix
Add these endpoint groups to core/specs/polymarket-clob.yaml. Prioritize tick-size and fee-rate endpoints as they directly affect order construction correctness.
Summary
Beyond the 5 endpoints tracked in #438, Polymarket's CLOB API has added 15+ additional endpoints that are not in
core/specs/polymarket-clob.yaml. These cover tick-size configuration, negative-risk market handling, fee-rate queries, sampling markets, and simplified market views.Impact
MEDIUM — these endpoints represent significant new API surface. Without them in the spec, PMXT cannot use callApi() to access them, and missing tick-size/fee-rate data may cause incorrect order construction.
Details
Missing endpoint groups:
GET /tick-size— returns tick size per market condition ID; needed for correct price roundingGET /neg-risk,POST /neg-risk/convert— neg-risk market metadata and position conversionGET /fee-rate— current taker/maker fee rates for the authenticated addressGET /sampling-markets,GET /sampling-simplified-markets— reduced market sets for sampling use casesGET /simplified-markets— condensed market list with fewer fields, for performanceGET /books(batch) — multi-market orderbook snapshot in one callGET /midpoints— batch midpoint prices for multiple condition IDsGET /spread,GET /spreads— current bid/ask spread dataGET /prices-history— OHLCV-style price history per marketGET /orders(batch status check by array of order IDs)Required Fix
Add these endpoint groups to
core/specs/polymarket-clob.yaml. Prioritize tick-size and fee-rate endpoints as they directly affect order construction correctness.