Polymarket US

polymarket_us

Polymarket US only. This toolkit connects to the CFTC-compliant Polymarket US product for United States users, not the global Polymarket app. API credentials are created at https://polymarket.us/developers after Polymarket US account verification.

Commerce Payment Processing Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (44)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Cancel All Open OrdersPOLYMARKET_US_CANCEL_ALL_OPEN_ORDERSAcción

Cancel all authenticated Polymarket US open orders, optionally scoped to specific market slugs. This is broad and destructive for remaining open quantities; omit slugs only when the user clearly asks to cancel every open order. Already executed fills and positions remain, so verify open orders afterward when confirmation matters.

Parámetros de entrada

slugsstring[]
Optional market slugs to restrict cancellation to. Omit only when the user explicitly wants every open order canceled across the account.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Cancel Multiple OrdersPOLYMARKET_US_CANCEL_MULTIPLE_ORDERSAcción

Cancel up to 20 Polymarket US open orders in one request. Use only when the user explicitly asks to cancel the batch. Cancellation removes remaining open quantity but does not undo fills or positions, and batch responses can require per-order follow-up reads to verify final state.

Parámetros de entrada

ordersobject[]Obligatorio
One to 20 open orders to cancel in a single batch. The request is destructive for remaining open quantities; confirm each order's final state when partial success or unknown order IDs matter.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Cancel OrderPOLYMARKET_US_CANCEL_ORDERAcción

Cancel one Polymarket US open order by exchange-assigned order ID. This is a destructive mutation of the remaining open quantity and should only be used when the user explicitly asks to cancel. Already executed fills and resulting positions remain; confirm order state afterward when precision matters.

Parámetros de entrada

orderIdstringObligatorio
Exchange-assigned open order ID to cancel. Canceling removes any remaining unfilled quantity but does not reverse fills that already executed.
marketSlugstringObligatorio
Market slug that contains the order being canceled.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Close Position OrderPOLYMARKET_US_CLOSE_POSITION_ORDERAcción

Create a live Polymarket US order intended to close an existing position in one market. Use only when the user explicitly asks to close that position. This can trade immediately, leave residual exposure if not fully filled, or be rejected for market, liquidity, risk, or funding checks; inspect the returned order state before confirming the position is closed.

Parámetros de entrada

marketSlugstringObligatorio
Market slug of the existing position to close. Use only for the market the user has identified.
maxBlockTimestring
Maximum block time in seconds when synchronousExecution is true.
slippageToleranceobject
Slippage tolerance for the close-position order. Wider tolerance can increase fill probability but may close at a worse price.
manualOrderIndicatorstringenum
Whether the close-position order is manual or automatic for audit and routing purposes.
MANUAL_ORDER_INDICATOR_MANUALMANUAL_ORDER_INDICATOR_AUTOMATIC
synchronousExecutionboolean
Whether to block until the close-position order reaches a final state. If false or omitted, read the order later to confirm fills or rejection.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Multiple OrdersPOLYMARKET_US_CREATE_MULTIPLE_ORDERSAcción

Submit up to 20 live Polymarket US orders in one request. Use only after the user explicitly asks to place the batch and, when practical, after previewing the same orders. This mutating action can consume buying power and create exposure across multiple markets; read per-order statuses because a batch can contain accepted, filled, and rejected orders.

Parámetros de entrada

ordersobject[]Obligatorio
One to 20 live orders to submit in a single batch. Preview each order first when possible; accepted orders can reserve funds, fill, or create market exposure, and individual orders may be rejected.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create OrderPOLYMARKET_US_CREATE_ORDERAcción

Submit one live Polymarket US order. Use Preview Order first unless the user has already reviewed the exact order details. This mutating action can reserve buying power, fill immediately, or create real market exposure; the API may also reject the order for funding, price, market, or risk checks, so inspect the returned status before confirming placement.

Parámetros de entrada

orderobjectObligatorio
Live order to submit after previewing the same parameters with Preview Order. Either intent or outcomeSide plus action must identify the side; accepted orders can immediately reserve funds, fill, or create market exposure.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Account BalancesPOLYMARKET_US_GET_ACCOUNT_BALANCESAcción

Get the authenticated user's Polymarket US account balances. Use this read-only action to inspect buying power, balances, pending credits, and funds reserved by open orders before previewing or placing orders. Requires Polymarket US signed authentication and returns only the signed-in account's balances.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get ActivitiesPOLYMARKET_US_GET_ACTIVITIESAcción

Get authenticated Polymarket US portfolio activities such as trades, resolutions, deposits, withdrawals, referral bonuses, and transfers. Requires Polymarket US signed authentication and returns activity only for that account. Use type filters and sortOrder carefully when paging through history.

Parámetros de entrada

limitinteger
Maximum account activities to return per page. Use with cursor for pagination; omit cursor on the first request.
typesstring[]
Activity types to include. Use ACTIVITY_TYPE_TRADE for executions, ACTIVITY_TYPE_POSITION_RESOLUTION for settlements, and account deposit/withdrawal types for cash movements.
cursorstring
Pagination cursor from a previous nextCursor field. Omit for the first page.
sortOrderstringenum
Activity timestamp sort order. DESCENDING returns newest first and is the API default; ASCENDING returns oldest first.
SORT_ORDER_DESCENDINGSORT_ORDER_ASCENDING
marketSlugstring
Market slug to filter account activities by. Only trades and resolutions tied to that market are returned; account-level deposits and withdrawals may not match a marketSlug.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Event By IDPOLYMARKET_US_GET_EVENT_BY_IDAcción

Get one Polymarket US event by numeric ID from the public gateway API. Use this after discovery when the caller already has the integer event ID and needs full event details or associated market references. Do not pass slugs here; use Get Event By Slug for slugs. This read-only action does not require API key authentication.

Parámetros de entrada

idintegerObligatorio
Numeric Polymarket US event ID from a discovery response. Do not pass an event slug.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Event By SlugPOLYMARKET_US_GET_EVENT_BY_SLUGAcción

Get one Polymarket US event by slug from the public gateway API. Use this after search/list discovery or when parsing a Polymarket event URL. Do not pass numeric IDs here; use Get Event By ID for integer IDs. This read-only action does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
Event slug from a Polymarket US event URL or discovery response. Do not pass the numeric event ID.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get League By SlugPOLYMARKET_US_GET_LEAGUE_BY_SLUGAcción

Get a current Polymarket US v2 league by slug. Use List Leagues or Get Sport By Slug first if the slug is unknown. This is useful for confirming league metadata before listing events for a league such as "nba" or "nfl". This action does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
Current v2 league slug from List Leagues or Get Sport By Slug, such as 'nba' or 'nfl'.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Market BBOPOLYMARKET_US_GET_MARKET_BBOAcción

Get the best bid and offer for one Polymarket US market by slug. Use this lightweight top-of-book read before quoting, previewing, or explaining an order. If the agent needs depth or slippage context, use Get Market Book instead. The response is market data, not an order placement or order preview. This endpoint requires the market slug, not the numeric market ID, and does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
Market slug from a Polymarket US market URL or discovery response. Do not pass the numeric market ID.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Market BookPOLYMARKET_US_GET_MARKET_BOOKAcción

Get the public order book for one Polymarket US market by slug. Use this before quoting, previewing, or explaining an order when the agent needs depth beyond the top of book. The response is market data, not an order placement or order preview. This endpoint requires the market slug, not the numeric market ID, and does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
Market slug from a Polymarket US market URL or discovery response. Do not pass the numeric market ID.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Market By IDPOLYMARKET_US_GET_MARKET_BY_IDAcción

Get one Polymarket US market by numeric ID from the public gateway API. Use this after market discovery when the caller already has the integer market ID and needs full market metadata. Do not pass slugs here; use Get Market By Slug for slugs. For current pricing before an order, follow with Get Market BBO or Get Market Book. This read-only action does not require API key authentication.

Parámetros de entrada

idintegerObligatorio
Numeric Polymarket US market ID from a discovery response. Do not pass a market slug.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Market By SlugPOLYMARKET_US_GET_MARKET_BY_SLUGAcción

Get one Polymarket US market by slug from the public gateway API. Use this after search/list discovery or when parsing a Polymarket market URL. Do not pass numeric IDs here; use Get Market By ID for integer IDs. For current pricing before quoting, previewing, or placing an order, follow with Get Market BBO or Get Market Book. This read-only action does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
Market slug from a Polymarket US market URL or discovery response. Do not pass the numeric market ID.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Market SettlementPOLYMARKET_US_GET_MARKET_SETTLEMENTAcción

Get settlement information for one Polymarket US market by slug. Use this only for resolved, closed, or historical market workflows where the caller needs public resolution or settlement details. It is not useful for discovering current markets or preparing trades on active markets. This endpoint requires the market slug, not the numeric market ID, and does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
Market slug from a Polymarket US market URL or discovery response. Do not pass the numeric market ID.
fromEp3boolean
Whether to request settlement data from EP3. Leave unset unless the caller specifically needs the EP3 settlement source.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Markets For SubjectPOLYMARKET_US_GET_MARKETS_FOR_SUBJECTAcción

Discover Polymarket US markets associated with a subject ID. Use this action after List Subjects or Get Subject By ID identifies the team, person, candidate, player, nominee, or other entity the user cares about. This is a market discovery tool, not a subject metadata lookup. This action does not require API key authentication.

Parámetros de entrada

idintegerObligatorio
Numeric subject ID for the team, person, candidate, player, nominee, or entity whose markets should be discovered.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Markets For Subject By SlugPOLYMARKET_US_GET_MARKETS_FOR_SUBJECT_BY_SLUGAcción

Discover Polymarket US markets associated with a subject slug. Use this action after List Subjects, Get Subject By Slug, or a Polymarket URL identifies the team, person, candidate, player, nominee, or other entity the user cares about. This is a market discovery tool, not a subject metadata lookup. This action does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
URL-safe subject slug for the team, person, candidate, player, nominee, or entity whose markets should be discovered.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Open OrdersPOLYMARKET_US_GET_OPEN_ORDERSAcción

Get all open orders for the authenticated Polymarket US user. Use this read-only action before modifying or canceling orders, or to inspect live order exposure. Requires signed authentication, supports optional market slug filters, and does not place, modify, or cancel orders.

Parámetros de entrada

slugsstring[]
Optional market slugs to filter this authenticated account's open orders. Pass multiple slugs to restrict results to those markets; omit to return open orders across all markets.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get OrderPOLYMARKET_US_GET_ORDERAcción

Get an authenticated user's Polymarket US order by exchange-assigned order ID. Requires signed authentication and returns order details available to that account. Use this read-only action to inspect order state after creating, modifying, or canceling an order.

Parámetros de entrada

orderIdstringObligatorio
Exchange-assigned order ID for an order owned by the authenticated account.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Series By IDPOLYMARKET_US_GET_SERIES_BY_IDAcción

Get a Polymarket US series by numeric ID. Series are recurring or grouped event collections. Use this action when an agent has a series ID and needs the slug, active status, recurrence, or other public metadata before fetching related events or markets. This action does not require API key authentication.

Parámetros de entrada

idintegerObligatorio
Numeric series ID returned by List Series or related event data.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Sport By SlugPOLYMARKET_US_GET_SPORT_BY_SLUGAcción

Get a current Polymarket US v2 sport by slug. Use List Sports first if the slug is unknown. The response includes the sport metadata and leagues attached to that sport, which helps agents move from broad sport browsing to league-specific event discovery. This action does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
Current v2 sport slug from List Sports. Examples include 'football' and 'basketball'.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Subject By IDPOLYMARKET_US_GET_SUBJECT_BY_IDAcción

Get a Polymarket US subject entity by numeric ID. Subjects represent teams, people, candidates, players, nominees, and other named entities attached to markets. Use this action when an agent already has a subject ID and needs its slug, type, or display metadata. This action does not require API key authentication.

Parámetros de entrada

idintegerObligatorio
Numeric subject ID returned by List Subjects or a market response.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Subject By SlugPOLYMARKET_US_GET_SUBJECT_BY_SLUGAcción

Get a Polymarket US subject entity by slug. Subjects represent teams, people, candidates, players, nominees, and other named entities attached to markets. Use this action when an agent has a subject slug from a URL or search result and needs the subject ID or display metadata. This action does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
URL-safe subject slug for a team, person, candidate, player, nominee, or other market entity.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Tag By IDPOLYMARKET_US_GET_TAG_BY_IDAcción

Get a Polymarket US topic, sport, or league tag by numeric ID. Use this action after List Tags or a market/event response returns a tag ID and the agent needs the tag label, slug, hierarchy, or sport/league metadata for filtering or display. This action does not require API key authentication.

Parámetros de entrada

idintegerObligatorio
Numeric tag ID returned by List Tags or another tag response.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Tag By SlugPOLYMARKET_US_GET_TAG_BY_SLUGAcción

Get a Polymarket US topic, sport, or league tag by slug. Use this action when an agent has a URL-safe tag slug, such as nba or sports, and needs the tag ID, label, hierarchy, or sport/league metadata for filtering or display. This action does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
URL-safe tag slug for a topic, sport, or league filter.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get User PositionsPOLYMARKET_US_GET_USER_POSITIONSAcción

Get the authenticated user's Polymarket US trading positions across all markets or filtered by a specific market slug. Requires Polymarket US signed authentication and only returns positions for that account. Use this read-only action to verify API credentials and inspect current exposure.

Parámetros de entrada

limitinteger
Maximum number of account-specific positions to return per page. Use with cursor for pagination; omit cursor on the first request.
cursorstring
Pagination cursor from a previous response's nextCursor field. Omit for the first page.
marketstring
Optional market slug to filter the authenticated account's positions. When omitted, returns positions across all markets for the signed-in Polymarket US account.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List EventsPOLYMARKET_US_LIST_EVENTSAcción

Discover Polymarket US events from the public gateway API. Use this action before event-specific lookups when starting from a topic, category, tag, or broad filter set. Practical guidance for agents: - For currently relevant events, start with active=true, closed=false, and archived=false, then paginate with limit and offset. - Pass numeric event IDs in id and event slugs in slug; do not mix the two identifier types. - Events may contain related markets, but use market-specific actions for market details, order books, BBO, settlement, or order preparation. - This read-only discovery action does not require Polymarket API key auth.

Parámetros de entrada

idinteger[]
Numeric event IDs to fetch. Do not pass event slugs here; use the slug filter for known event slugs.
slugstring[]
Known event slugs from Polymarket URLs or discovery responses. Do not pass numeric event IDs.
limitinteger
Maximum number of events to return for this page. Use with offset to page through discovery results; the API supports up to 100 per call.
activeboolean
Filter by whether the event is currently active. For tradable discovery, commonly combine active=true with closed=false and archived=false.
closedboolean
Filter by whether the event is closed. Set closed=false when looking for open/current events; set closed=true for historical or resolved event research.
offsetinteger
Zero-based number of events to skip. Increase by limit for subsequent pages when scanning many events.
tagIdsinteger[]
Numeric tag IDs to include. Use tagSlug when filtering by a readable tag such as nba or nfl.
orderBystring[]
Response fields to sort by, such as updatedAt, startDate, endDate, volume, or liquidity. Pass as an array even for one field.
tagSlugstring
Tag slug such as nba or nfl. This is a readable slug, not a numeric tag ID.
archivedboolean
Filter by whether the event is archived. Archived events are usually not useful for current market discovery.
seriesIdinteger[]
Numeric series IDs to restrict discovery to specific event series. Pass as an array even for one series.
categoriesstring[]
Event categories to include, such as sports. Combine with tagSlug, seriesId, or marketTypes to narrow broad result sets.
marketTypesstring[]
Market type strings to include. For sports, values commonly identify market families such as moneyline, spread, totals, props, or futures.
includeHiddenboolean
Whether to include hidden events. Leave false or omit for normal agentic discovery; hidden events may be incomplete or not intended for user-facing results.
orderDirectionstringenum
Sort direction for orderBy. Use desc for newest or highest values first, asc for oldest or lowest first.
ascdesc

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Events For LeaguePOLYMARKET_US_LIST_EVENTS_FOR_LEAGUEAcción

List Polymarket US events for a current v2 league slug such as "nba" or "nfl". Use List Leagues or Get Sport By Slug first if the slug is unknown. Supports limit/offset pagination, excludeEventId for de-duplicating already-seen events, and optional type/section filters. This action does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
Current v2 league slug from List Leagues or Get Sport By Slug, such as 'nba' or 'nfl'.
typestringenum
Event type filter. Use 'sport' for standard games or 'futures' for futures markets.
sportfutures
limitinteger
Maximum events to return for this page.
offsetinteger
Number of events to skip before returning this page. Use with limit for pagination.
sectionstringenum
Event section filter. Use 'general' for the standard list or 'trending' for trending events.
generaltrending
excludeEventIdinteger[]
Event IDs to omit from the results. Use this when paginating or composing multiple league sections and you need to avoid duplicate events.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Events For SeriesPOLYMARKET_US_LIST_EVENTS_FOR_SERIESAcción

List Polymarket US sports events for a legacy v1 series ID. Prefer List Events For Sport or List Events For League for current v2 browsing. Use this action when an agent already has a series ID from a legacy sports workflow and needs related events. Supports limit/offset pagination, excludeEventId for de-duplicating already-seen events, and optional type/section filters. This action does not require API key authentication.

Parámetros de entrada

typestringenum
Event type filter. Use 'sport' for standard games or 'futures' for futures markets.
sportfutures
limitinteger
Maximum events to return for this page.
offsetinteger
Number of events to skip before returning this page. Use with limit for pagination.
sectionstringenum
Event section filter. Use 'general' for the standard list or 'trending' for trending events.
generaltrending
seriesIdintegerObligatorio
Legacy v1 sport series ID. Prefer v2 sport or league event tools for current browsing; use this only when a v1 series ID is already known.
excludeEventIdinteger[]
Event IDs to omit from the results. Use this when paginating or composing multiple legacy series sections and you need to avoid duplicate events.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Events For SportPOLYMARKET_US_LIST_EVENTS_FOR_SPORTAcción

List Polymarket US events for a current v2 sport slug such as "football" or "basketball". Use List Sports first if the slug is unknown. Supports limit/offset pagination, excludeEventId for de-duplicating already-seen events, and optional type/section filters. This action does not require API key authentication.

Parámetros de entrada

slugstringObligatorio
Current v2 sport slug from List Sports, such as 'football' or 'basketball'.
typestringenum
Event type filter. Use 'sport' for standard games or 'futures' for futures markets.
sportfutures
limitinteger
Maximum events to return for this page.
offsetinteger
Number of events to skip before returning this page. Use with limit for pagination.
sectionstringenum
Event section filter. Use 'general' for the standard list or 'trending' for trending events.
generaltrending
excludeEventIdinteger[]
Event IDs to omit from the results. Use this when paginating or composing multiple sports sections and you need to avoid duplicate events.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Featured TagsPOLYMARKET_US_LIST_FEATURED_TAGSAcción

List featured Polymarket US tag sections from the public gateway API. Featured tags are curated browse sections, often with subtags, intended for discovery UI and recommendation flows rather than exhaustive filtering. Use List Tags when the agent needs the full searchable tag set. This action does not require API key authentication.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List LeaguesPOLYMARKET_US_LIST_LEAGUESAcción

List current Polymarket US sports leagues from the v2 public gateway API. This is the preferred action for discovering league slugs such as "nfl" or "nba" before calling Get League By Slug or List Events For League. Supports limit/offset pagination with a maximum page size of 50. This action does not require API key authentication.

Parámetros de entrada

limitinteger
Maximum leagues to return for this page. The v2 API allows up to 50.
offsetinteger
Number of leagues to skip before returning this page. Use with limit for pagination.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List MarketsPOLYMARKET_US_LIST_MARKETSAcción

Discover Polymarket US markets from the public gateway API. Use this action when an agent needs candidate market slugs or IDs before reading market details, order books, best bid/offer, or preparing orders. Practical guidance for agents: - For currently tradable candidates, start with active=true, closed=false, and archived=false, then paginate with limit and offset. - Pass numeric market IDs in id and market slugs in slug; do not mix the two identifier types. - Discovery results are not a substitute for live pricing. Before quoting, previewing, or placing an order, read Get Market BBO for top-of-book or Get Market Book for depth. - This read-only discovery action does not require Polymarket API key auth.

Parámetros de entrada

idinteger[]
Numeric market IDs to fetch. Do not pass market slugs here; use the slug filter for known market slugs.
slugstring[]
Known market slugs from Polymarket URLs or discovery responses. Do not pass numeric market IDs.
limitinteger
Maximum number of markets to return for this page. Use with offset to page through discovery results; the API supports up to 100 per call.
activeboolean
Filter by whether the market is currently active. For tradable discovery, commonly combine active=true with closed=false and archived=false.
closedboolean
Filter by whether the market is closed. Set closed=false before preparing orders; set closed=true for historical or settlement research.
offsetinteger
Zero-based number of markets to skip. Increase by limit for subsequent pages when scanning many markets.
tagIdsinteger[]
Numeric tag IDs to include. Use list/search discovery first if the caller only has a readable tag slug.
orderBystring[]
Response fields to sort by, such as updatedAt, startDate, endDate, volumeNum, liquidity, or closedTime. Pass as an array even for one field.
archivedboolean
Filter by whether the market is archived. Archived markets are usually not suitable for current trading workflows.
categoriesstring[]
Market categories to include, such as sports. Use broad categories first, then narrow with marketTypes, sportsMarketTypes, or tagIds.
marketTypesstring[]
Market type strings to include. For sports, values commonly identify market families such as moneyline, spread, totals, props, or futures.
includeHiddenboolean
Whether to include hidden markets. Leave false or omit for normal agentic discovery; hidden markets may be incomplete or not intended for user-facing results.
orderDirectionstringenum
Sort direction for orderBy. Use desc for newest or highest values first, asc for oldest or lowest first.
ascdesc
sportsMarketTypesstring[]
Structured sports market type enum values. Use this instead of free-form marketTypes when the caller knows the sports market family.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List SeriesPOLYMARKET_US_LIST_SERIESAcción

List Polymarket US series from the public gateway API. Series are recurring or grouped event collections, such as seasonal or repeated sports event groupings. Use this action to discover a series ID or slug before fetching related events or markets with series-aware tools. This action does not require API key authentication.

Parámetros de entrada

slugstring[]
Filter to one or more URL-safe series slugs.
limitinteger
Maximum number of recurring or grouped event series to return.
activeboolean
When true, return only active series; when false, inactive series.
offsetinteger
Zero-based number of series to skip before returning results.
orderBystring[]
Response fields to sort series by, such as updatedAt.
recurrencestring
Filter by recurrence pattern for recurring event collections, such as daily or weekly when supported by the API.
orderDirectionstringenum
Sort direction for orderBy fields.
ascdesc

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List SportsPOLYMARKET_US_LIST_SPORTSAcción

List Polymarket US sports from the current v2 public gateway API. Use this for sports browsing and for discovering sport slugs such as "football" or "basketball" before calling Get Sport By Slug or List Events For Sport. This action does not require API key authentication.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Sports TeamsPOLYMARKET_US_LIST_SPORTS_TEAMSAcción

List Polymarket US sports teams from the legacy v1 public gateway API. Use this action when an agent needs team metadata for sports events or needs to filter teams by league, name, abbreviation, or Polymarket team ID. The Pydantic filter fields named filters_* are translated to the dotted API query names filters.league, filters.name, filters.abbreviation, and filters.id. This action does not require API key authentication.

Parámetros de entrada

limitinteger
Maximum teams to return for this page.
offsetinteger
Number of teams to skip before returning this page. Use with limit for pagination.
orderBystring[]
Team fields to order by. Common values include 'name', 'league', 'abbreviation', and 'id'.
filters_idinteger[]
Polymarket team IDs to filter by. This Pydantic field is sent to the API as 'filters.id'.
filters_namestring[]
Team names to filter by. This Pydantic field is sent to the API as 'filters.name'.
filters_leaguestring[]
League slugs to filter by. This Pydantic field is sent to the API as 'filters.league'.
orderDirectionstringenum
Sort direction for orderBy. Use 'asc' or 'desc'.
ascdesc
filters_abbreviationstring[]
Team abbreviations to filter by. This Pydantic field is sent to the API as 'filters.abbreviation'.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Sports Teams For ProviderPOLYMARKET_US_LIST_SPORTS_TEAMS_FOR_PROVIDERAcción

List Polymarket US legacy v1 sports team mappings for a data provider. Use this action when an agent needs provider-specific team IDs for SportsDataIO or Sportradar integrations. Pass provider as the enum value "PROVIDER_SPORTSDATAIO" or "PROVIDER_SPORTRADAR"; optionally narrow by Polymarket teamIds and league slug. This action does not require API key authentication.

Parámetros de entrada

leaguestring
League slug to limit provider mappings, such as 'nba' or 'nfl'.
teamIdsstring[]
Polymarket team IDs to map to provider-specific team IDs. Values are strings in this API.
providerstringenum
Sports data provider enum. Use 'PROVIDER_SPORTSDATAIO' or 'PROVIDER_SPORTRADAR'.
PROVIDER_SPORTSDATAIOPROVIDER_SPORTRADAR

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List SubjectsPOLYMARKET_US_LIST_SUBJECTSAcción

List Polymarket US subject entities from the public gateway API. Subjects are teams, people, candidates, players, nominees, or other named entities that markets can be about. Use this action to discover the subject ID or slug before calling the subject market lookup tools. This action does not require API key authentication.

Parámetros de entrada

limitinteger
Maximum number of subject entities to return.
querystring
Search text for a subject name or display name, such as a team, person, candidate, player, or other market entity.
offsetinteger
Zero-based number of subjects to skip before returning results.
subjectTypestring
Filter by subject type, for example team, player, nominee, candidate, or golf_player.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List TagsPOLYMARKET_US_LIST_TAGSAcción

List ranked Polymarket US tags from the public gateway API. Tags are topic, sport, league, and browse filters that agents can use to narrow event or market discovery before calling event and market listing tools. Use parentSlug="sports" to discover sports and league tags. This action does not require API key authentication.

Parámetros de entrada

idsinteger[]
Filter to one or more numeric tag IDs returned by tag lookups.
slugstring[]
Filter to one or more tag slugs, such as a league or topic slug.
limitinteger
Maximum number of topic, sport, or league tags to return.
offsetinteger
Zero-based number of tags to skip before returning results.
orderBystring[]
Response fields to sort tags by, such as label or updatedAt.
parentIdinteger
Filter to child tags under this parent tag ID. Ignored when parentSlug is also provided.
parentSlugstring
Filter to child tags under this parent slug, such as sports. Takes priority over parentId.
orderDirectionstringenum
Sort direction for orderBy fields.
ascdesc

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Modify Multiple OrdersPOLYMARKET_US_MODIFY_MULTIPLE_ORDERSAcción

Modify up to 20 Polymarket US open orders in one request. Use only when the user explicitly asks to change the batch. These live cancel-replace style mutations can change funding requirements, exposure, maker-only behavior, queue priority, and fill risk; the response can be partial, so confirm per-order state after modification when accuracy matters.

Parámetros de entrada

ordersobject[]Obligatorio
One to 20 existing open orders to modify in a single batch. Each item may affect price, quantity, maker-only behavior, funding, and queue priority; inspect each result afterward.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Modify OrderPOLYMARKET_US_MODIFY_ORDERAcción

Modify one existing Polymarket US open order. This is a live cancel-replace style mutation and should only be used when the user explicitly asks to change an order. It can alter exposure, required funds, queue priority, and fill behavior; verify the updated order state after the request when confirmation matters.

Parámetros de entrada

tifstringenum
Replacement time-in-force policy. Immediate-or-cancel and fill-or-kill can cancel unfilled size instead of leaving a resting order.
TIME_IN_FORCE_DAYTIME_IN_FORCE_GOOD_TILL_CANCELTIME_IN_FORCE_GOOD_TILL_DATETIME_IN_FORCE_IMMEDIATE_OR_CANCELTIME_IN_FORCE_FILL_OR_KILL
priceobject
Replacement limit price and currency. Changing price can alter fill probability and may trigger immediate execution depending on tif and maker-only settings.
orderIdstringObligatorio
Exchange-assigned open order ID to modify. The API treats this as a live cancel-replace style mutation of that order.
quantitynumber
Replacement total order quantity in shares, not an increment. Larger quantities may require additional available buying power.
marketSlugstringObligatorio
Market slug for the open order being modified.
goodTillTimestring
Expiration timestamp for TIME_IN_FORCE_GOOD_TILL_DATE orders. Omit for other tif values.
participateDontInitiateboolean
Set true to require maker-only behavior. A maker-only modification may be rejected or remain unfilled if it would immediately take liquidity.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Preview OrderPOLYMARKET_US_PREVIEW_ORDERAcción

Preview a Polymarket US order without submitting it to the market. Use this signed, read-only action before live order creation to validate parameters and inspect the calculated order response. It requires Polymarket US signed authentication but does not create, modify, cancel, or reserve funds for an order.

Parámetros de entrada

orderobjectObligatorio
Order request to preview only. This validates parameters and expected order effects but does not place an order. Either intent or outcomeSide plus action must identify the desired side.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Search Markets And EventsPOLYMARKET_US_SEARCH_MARKETS_AND_EVENTSAcción

Search public Polymarket US markets and events for discovery. Use this for natural-language discovery when an agent needs candidate market or event slugs/IDs before calling specific market/event endpoints. Search results should not be treated as live pricing or trading readiness: after selecting a market, read the market details and then Get Market BBO or Get Market Book before quoting, previewing, or placing an order. Use page and limit to paginate. This read-only action does not require API key authentication.

Parámetros de entrada

pageinteger
One-based search results page number. Increase this with the same limit to continue through additional discovery results.
limitinteger
Maximum search results to return on this page. Use with page for pagination; the API supports up to 100 per call.
querystring
Natural-language discovery query, such as a team, league, event, or market topic. Search is for finding candidate events/markets, not for pricing or trading.
statusstring
Status filter for search results, such as open for current markets/events or closed for historical results when supported.
seriesIdsinteger[]
Numeric series IDs to restrict search results. Pass as an array even for one series.
marketTypestring[]
Market type strings to restrict search results, such as futures, moneyline, spread, total, or prop when supported by the result set.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not