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.
This is a first-class FlyMyAI MCP. Agents discover it automatically via tool search and call the actions below on demand - you never wire it up by hand. See the Composio catalog for how discovery works.
Connect
Polymarket US authenticates with an API key. Generate the credential in your Polymarket US account, then paste it into FlyMyAI the first time an agent uses a Polymarket US action.
Get your Polymarket US credential →
Fields to fill in FlyMyAI
| Field | Details |
|---|---|
Secret Key | Ed25519 secret key for Polymarket US only. Get it from https://polymarket.us/developers after signing in to a verified Polymarket US account. It is shown once when creating an API key; save it before leaving the page. This key signs each request locally and is stored encrypted by Composio. (required) |
Key ID | Public key ID for the same Polymarket US API key as the Secret Key. Get it from https://polymarket.us/developers; it is shown next to the Secret Key when the API key is created. This is the X-PM-Access-Key value and is not a secret. (required) |
Actions
Every action this integration exposes. Agents pick the right one from the task; you do not call them by name.
| Action | What it does | Required inputs |
|---|---|---|
POLYMARKET_US_CANCEL_ALL_OPEN_ORDERS | 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 posi… | - |
POLYMARKET_US_CANCEL_MULTIPLE_ORDERS | 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… | orders |
POLYMARKET_US_CANCEL_ORDER | 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 or… | orderId, marketSlug |
POLYMARKET_US_CLOSE_POSITION_ORDER | 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, liquidit… | marketSlug |
POLYMARKET_US_CREATE_MULTIPLE_ORDERS | 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 marke… | orders |
POLYMARKET_US_CREATE_ORDER | 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 f… | order |
POLYMARKET_US_GET_ACCOUNT_BALANCES | 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… | - |
POLYMARKET_US_GET_ACTIVITIES | 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 c… | - |
POLYMARKET_US_GET_EVENT_BY_ID | 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 sl… | id |
POLYMARKET_US_GET_EVENT_BY_SLUG | 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 aut… | slug |
POLYMARKET_US_GET_LEAGUE_BY_SLUG | 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 au… | slug |
POLYMARKET_US_GET_MARKETS_FOR_SUBJECT | 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… | id |
POLYMARKET_US_GET_MARKETS_FOR_SUBJECT_BY_SLUG | 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 discov… | slug |
POLYMARKET_US_GET_MARKET_BBO | 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,… | slug |
POLYMARKET_US_GET_MARKET_BOOK | 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… | slug |
POLYMARKET_US_GET_MARKET_BY_ID | 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 pri… | id |
POLYMARKET_US_GET_MARKET_BY_SLUG | 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,… | slug |
POLYMARKET_US_GET_MARKET_SETTLEMENT | 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 t… | slug |
POLYMARKET_US_GET_OPEN_ORDERS | 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,… | - |
POLYMARKET_US_GET_ORDER | 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 orde… | orderId |
POLYMARKET_US_GET_SERIES_BY_ID | 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… | id |
POLYMARKET_US_GET_SPORT_BY_SLUG | 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… | slug |
POLYMARKET_US_GET_SUBJECT_BY_ID | 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 metada… | id |
POLYMARKET_US_GET_SUBJECT_BY_SLUG | 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… | slug |
POLYMARKET_US_GET_TAG_BY_ID | 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… | id |
POLYMARKET_US_GET_TAG_BY_SLUG | 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… | slug |
POLYMARKET_US_GET_USER_POSITIONS | 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 credential… | - |
POLYMARKET_US_LIST_EVENTS | 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, cl… | - |
POLYMARKET_US_LIST_EVENTS_FOR_LEAGUE | 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/secti… | slug |
POLYMARKET_US_LIST_EVENTS_FOR_SERIES | 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… | seriesId |
POLYMARKET_US_LIST_EVENTS_FOR_SPORT | 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.… | slug |
POLYMARKET_US_LIST_FEATURED_TAGS | 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 fu… | - |
POLYMARKET_US_LIST_LEAGUES | 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 max… | - |
POLYMARKET_US_LIST_MARKETS | 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 trada… | - |
POLYMARKET_US_LIST_SERIES | 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 serie… | - |
POLYMARKET_US_LIST_SPORTS | 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 a… | - |
POLYMARKET_US_LIST_SPORTS_TEAMS | 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_… | - |
POLYMARKET_US_LIST_SPORTS_TEAMS_FOR_PROVIDER | 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"… | - |
POLYMARKET_US_LIST_SUBJECTS | 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… | - |
POLYMARKET_US_LIST_TAGS | 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… | - |
POLYMARKET_US_MODIFY_MULTIPLE_ORDERS | 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… | orders |
POLYMARKET_US_MODIFY_ORDER | 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 o… | marketSlug, orderId |
POLYMARKET_US_PREVIEW_ORDER | 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 crea… | order |
POLYMARKET_US_SEARCH_MARKETS_AND_EVENTS | 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… | - |
Links
We love our partners - FlyMy.AI builds with the best. Thanks, Polymarket US!