All integrations

Polymarket US

BUSINESS · COMMERCE & FINANCE

Markets, events, and prices on the US exchange, plus their own orders and positions.

Connecting Polymarket US in practice

Polymarket US signs every request with Ed25519 rather than sending a bearer token: X-PM-Access-Key, X-PM-Timestamp and X-PM-Signature over the timestamp, method and path, and a timestamp more than 30 seconds off server time is rejected, so an agent needs a correct clock as much as a key. The limit is 20 requests per second per API key, and 20 per second per IP on unauthenticated endpoints.

Rate limits

  • 20 requests per second per API key on authenticated endpoints.
  • 20 requests per second per IP on unauthenticated or public endpoints.
  • Exceeding it returns { "status": 429, "message": "Too Many Requests" }.

Who has to approve

Identity verification comes before API access. The documented path is to create an account in the Polymarket US app, complete KYC identity verification, then create a Key ID and Secret Key in the developer portal at polymarket.us/developer; the secret key is shown only once.

Worth knowing

  • A rejection reading "Global Rate Limit Exceeded" is not a rate limit: it is a 5-second latency stopgap on order processing, and the documentation says not to throttle traffic in response to it.
  • Because the signature covers a timestamp with a 30-second tolerance, clock drift on the caller looks exactly like a bad key.
  • The documented mitigation for anything live is WebSocket streams plus caching of reference data, not a faster REST poll.
  • Polymarket US is a separate documentation set and developer portal from polymarket.com, whose builder tiers cap Relayer transactions at 100 a day until a builder is verified by email — do not read one set of limits as the other.

Checked against Rate limits (2026-09-29), Authentication (2026-09-29), Builder tiers (polymarket.com) (2026-09-29)

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

polymarketus_delete_v1_rfqs_by_rfqidWRITE

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.

api
polymarketus_delete_v1_rfqs_by_rfqid_quotes_by_quoteidWRITE

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.

api
polymarketus_get_v1_account_balancesREAD

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.

api
polymarketus_get_v1_combosREAD

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.

api
polymarketus_get_v1_eventsREAD

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

api
polymarketus_get_v1_events_by_idREAD

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

api
polymarketus_get_v1_events_slug_by_slugREAD

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

api
polymarketus_get_v1_incentivesREAD

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

api
polymarketus_get_v1_incentives_earningsREAD

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.

api
polymarketus_get_v1_market_id_by_idREAD

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

api
polymarketus_get_v1_market_slug_by_slugREAD

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

api
polymarketus_get_v1_marketsREAD

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

api
polymarketus_get_v1_markets_by_slug_bboREAD

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.

api
polymarketus_get_v1_markets_by_slug_bookREAD

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.

api
polymarketus_get_v1_markets_by_slug_settlementREAD

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.

api
polymarketus_get_v1_order_by_orderidREAD

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.

api
polymarketus_get_v1_orders_openREAD

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.

api
polymarketus_get_v1_partners_by_partnerkey_events_by_externalidREAD

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.

api
polymarketus_get_v1_portfolio_activitiesREAD

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.

api
polymarketus_get_v1_portfolio_positionsREAD

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.

api
polymarketus_get_v1_price_historyREAD

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.

api
polymarketus_get_v1_rfqsREAD

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.

api
polymarketus_get_v1_rfqs_quotesREAD

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.

api
polymarketus_get_v1_rfqs_user_idREAD

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.

api
polymarketus_get_v1_searchREAD

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

api
polymarketus_get_v1_seriesREAD

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

api
polymarketus_get_v1_series_id_by_idREAD

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

api
polymarketus_get_v1_sportsREAD

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

api
polymarketus_get_v1_sports_by_seriesid_eventsREAD

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.

api
polymarketus_get_v1_sports_playersREAD

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.

api
polymarketus_get_v1_sports_teamsREAD

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

api
polymarketus_get_v1_sports_teams_providerREAD

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.

api
polymarketus_get_v2_leaguesREAD

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

api
polymarketus_get_v2_leagues_by_slugREAD

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

api
polymarketus_get_v2_leagues_by_slug_eventsREAD

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.

api
polymarketus_get_v2_sportsREAD

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

api
polymarketus_get_v2_sports_by_slugREAD

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.

api
polymarketus_get_v2_sports_by_slug_eventsREAD

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.

api
polymarketus_get_v2_tagsREAD

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

api
polymarketus_get_v2_tags_by_idREAD

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

api
polymarketus_get_v2_tags_by_slug_eventsREAD

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.

api
polymarketus_get_v2_tags_slug_by_slugREAD

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

api
polymarketus_post_v1_combosWRITE

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.

api
polymarketus_post_v1_order_by_orderid_cancelWRITE

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.

api
polymarketus_post_v1_order_previewWRITE

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.

api
polymarketus_post_v1_orders_batched_cancelWRITE

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.

api
polymarketus_post_v1_orders_open_cancelWRITE

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.

api

Put Polymarket US behind one governed endpoint.

Same permissions, same audit trail, whatever else you connect next.