Polymarket US

Closes an open RFQ. Polymarket US DELETE https://api.polymarket.us/v1/rfqs/{rfqId}. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Deletes a quote so it can no longer be accepted. Polymarket US DELETE https://api.polymarket.us/v1/rfqs/{rfqId}/quotes/{quoteId}. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Get user's current account balances including buying power, asset values, and pending transactions. Polymarket US GET https://api.polymarket.us/v1/account/balances. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Returns the combo matching the exact symbol. Polymarket US GET https://api.polymarket.us/v1/combos. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Retrieve all events. Polymarket US GET https://gateway.polymarket.us/v1/events. Public market data; needs no credential.

Retrieve a specific event by its ID. Polymarket US GET https://gateway.polymarket.us/v1/events/{id}. Public market data; needs no credential.

Retrieve an event by its slug. Polymarket US GET https://gateway.polymarket.us/v1/events/slug/{slug}. Public market data; needs no credential.

Returns active and historical incentive programs grouped by market. Polymarket US GET https://gateway.polymarket.us/v1/incentives. Public market data; needs no credential.

Returns rewards earned by the authenticated caller. Each entry sums all payouts for a single (market, date) pair, where date is in Eastern Time. Polymarket US GET https://api.polymarket.us/v1/incentives/earnings. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Retrieve a specific market by its ID. Polymarket US GET https://gateway.polymarket.us/v1/market/id/{id}. Public market data; needs no credential.

Retrieve a specific market by its slug. Polymarket US GET https://gateway.polymarket.us/v1/market/slug/{slug}. Public market data; needs no credential.

Retrieve all markets. Polymarket US GET https://gateway.polymarket.us/v1/markets. Public market data; needs no credential.

Retrieve current market data (best bid/offer, stats) for a specific market by its slug in a lightweight format. Polymarket US GET https://gateway.polymarket.us/v1/markets/{slug}/bbo. Public market data; needs no credential.

Retrieve current market data (order book, stats) for a specific market by its slug. Polymarket US GET https://gateway.polymarket.us/v1/markets/{slug}/book. Public market data; needs no credential.

Retrieve the settlement price for a specific market by its slug. Polymarket US GET https://gateway.polymarket.us/v1/markets/{slug}/settlement. Public market data; needs no credential.

Get details for a specific order by its exchange-assigned ID. Polymarket US GET https://api.polymarket.us/v1/order/{orderId}. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Get all open orders for the authenticated user. Polymarket US GET https://api.polymarket.us/v1/orders/open. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Resolve a partner external event ID (e.g. OpticOdds fixture ID) to the internal event and its mapped market sides. Polymarket US GET https://gateway.polymarket.us/v1/partners/{partnerKey}/events/{externalId}. Public market data; needs no credential.

Get activities for a user including trades, position resolutions, and account balance changes. Polymarket US GET https://api.polymarket.us/v1/portfolio/activities. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Get user's trading positions across all markets or filtered by specific market. Polymarket US GET https://api.polymarket.us/v1/portfolio/positions. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Returns book-derived Yes and No display prices for one market. Use the market slug as `symbol`. Supported fixed profiles: - `INTERVAL_1H` with `fidelity=1`: approximately one-minute points for the last hour - `INTERVAL_6H` with `fidelity=1`: approximately one-minute points for the last six hours - `INTERVAL_1D` with `fidelity=5`: five-minute points for the last day - `INTERVAL_1W` with `fidelity=180`: three-hour points for the last week - `INTERVAL_1M` with `fidelity=180`: three-hour points for the last 30 days - `INTERVAL_ALL` with `fidelity=180`: three-hour points for newer markets and daily points for longer histories - `INTERVAL_LIVE` with `fidelity=1`: from 15 minutes before the event starts through now For a custom range, provide both Unix timestamps and use `fidelity=1`. Custom ranges are intended for short windows of up to 24 hours and return stored observations, which may be irregular or more frequent than once per minute. `longPrice` is the Yes display price, normally derived from the best ask. `shortPrice` is the No display price, normally derived from one minus the best bid. They can sum to more than 1 because they preserve the bid-ask spread; these are not individual trades. The endpoint supports one market per request. Cache identical responses for at least 30 seconds, stagger refreshes across markets, and observe the [20 requests/second/IP public limit](/api-reference/rate-limits). For live updates after loading history, use the [Markets WebSocket](/api-reference/websocket/markets). Polymarket US GET https://gateway.polymarket.us/v1/price-history. Public market data; needs no credential.

Returns RFQs matching the query filters. Polymarket US GET https://api.polymarket.us/v1/rfqs. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Returns quotes matching the query filters. Polymarket US GET https://api.polymarket.us/v1/rfqs/quotes. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Returns the public RFQ user ID for the authenticated participant. Polymarket US GET https://api.polymarket.us/v1/rfqs/user-id. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Search for a given query. Polymarket US GET https://gateway.polymarket.us/v1/search. Public market data; needs no credential.

Retrieve all series. Polymarket US GET https://gateway.polymarket.us/v1/series. Public market data; needs no credential.

Retrieve a specific series by its ID. Polymarket US GET https://gateway.polymarket.us/v1/series/id/{id}. Public market data; needs no credential.

Fetch sports data. Polymarket US GET https://gateway.polymarket.us/v1/sports. Public market data; needs no credential.

Retrieve events sections for a sport series (optional trending, optional live, and sport section). Same structure as home page. Polymarket US GET https://gateway.polymarket.us/v1/sports/{seriesId}/events. Public market data; needs no credential.

Fetch sports players, filterable by abbreviation, name, id, team, or provider reference. Polymarket US GET https://gateway.polymarket.us/v1/sports/players. Public market data; needs no credential.

Fetch sports teams data for enriching sports events. Polymarket US GET https://gateway.polymarket.us/v1/sports/teams. Public market data; needs no credential.

Fetch sports teams data for a specific provider. Polymarket US GET https://gateway.polymarket.us/v1/sports/teams/provider. Public market data; needs no credential.

Retrieve leagues with pagination (max 50 per page). Polymarket US GET https://gateway.polymarket.us/v2/leagues. Public market data; needs no credential.

Retrieve a league by its slug. Polymarket US GET https://gateway.polymarket.us/v2/leagues/{slug}. Public market data; needs no credential.

Retrieve events for a league by its slug (e.g., 'nfl', 'nba'). Resolves the league to its active series and returns events. Polymarket US GET https://gateway.polymarket.us/v2/leagues/{slug}/events. Public market data; needs no credential.

Retrieve all sports. Polymarket US GET https://gateway.polymarket.us/v2/sports. Public market data; needs no credential.

Retrieve a sport by its slug, with all leagues attached. Polymarket US GET https://gateway.polymarket.us/v2/sports/{slug}. Public market data; needs no credential.

Retrieve events for a sport by its slug (e.g., 'football', 'basketball'). Fetches all leagues for the sport, collects their active series, and returns combined events. Polymarket US GET https://gateway.polymarket.us/v2/sports/{slug}/events. Public market data; needs no credential.

Get ranked tags with optional filtering. Polymarket US GET https://gateway.polymarket.us/v2/tags. Public market data; needs no credential.

Get a tag by its ID. Polymarket US GET https://gateway.polymarket.us/v2/tags/{id}. Public market data; needs no credential.

Get events filtered by tag slug, sorted by volume descending by default. Polymarket US GET https://gateway.polymarket.us/v2/tags/{slug}/events. Public market data; needs no credential.

Get a tag by its slug. Polymarket US GET https://gateway.polymarket.us/v2/tags/slug/{slug}. Public market data; needs no credential.

Creates or returns the combo instrument for the supplied legs. The participant associated with the authenticated API key may create up to 1,000 new combo instruments per week across all of its accounts. The quota resets Monday at 00:00 UTC. Returning an existing canonical combo does not consume the quota. Polymarket US POST https://api.polymarket.us/v1/combos. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Cancel a specific order by its exchange-assigned ID. Polymarket US POST https://api.polymarket.us/v1/order/{orderId}/cancel. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Preview an order before submission to validate parameters and see expected fills. Polymarket US POST https://api.polymarket.us/v1/order/preview. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Cancel up to 20 orders in a single request. If any entry fails request-shape validation, the whole batch is rejected by the gateway before reaching the exchange. The exchange may silently ignore unknown `orderId`s. `canceledOrderIds` is an echo of the request, not a confirmation; observe actual outcomes on the order stream. Polymarket US POST https://api.polymarket.us/v1/orders/batched/cancel. Authenticated: runs against the connected Polymarket US account and is signed with its API key.

Cancel all open orders, optionally filtered by market slugs. Polymarket US POST https://api.polymarket.us/v1/orders/open/cancel. Authenticated: runs against the connected Polymarket US account and is signed with its API key.