Polymarket US

Tracks your prediction market positions in real time, monitors market price shifts, and executes trades based on custom triggers.

Try Polymarket US in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Polymarket US integration

    • Describe the outcome and Ceven picks the right Polymarket US calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Polymarket US data, across all 44 of its actions.
  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Polymarket US access.
    • Per user and per environment credentials instead of shared keys.
  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Polymarket US, when, and on whose behalf.
    • The agent pauses and asks when Polymarket US is unclear instead of plowing ahead.
  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Polymarket US.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Polymarket US action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Polymarket US, and when to use it.

Create order
Use this to submit a live buy or sell order. Ensure you preview the order first to verify price and quantity.
Cancel order
Use this to remove a specific open order by its exchange ID to free up reserved buying power.
Close position order
Use this to create an order that specifically targets and closes an existing market position.
Get account balances
Pull current buying power, pending credits, and total funds available in the account.
Get user positions
List all current holdings across markets or filter by a specific market slug.
Get market BBO
Pull the best bid and offer for a market slug for a quick price check.
Get market book
Pull the full public order book to analyze depth and potential slippage.
Get open orders
List all active orders that have not yet been filled or canceled.
List markets
Search for available markets to find candidate slugs or IDs for trading.
Get event by slug
Pull full details for a specific event using its unique URL slug.
Cancel all open orders
Use this to wipe all active orders across the account or within specific market slugs.
Get activities
Pull a history of trades, resolutions, deposits, and withdrawals for the account.
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 ord
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 ac
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 E
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
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 slu
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 q
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 mar
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
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
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, o
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 event
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 ev
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
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 need
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
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 do
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 w
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

30 actions · scroll to see them all

Frequently asked questions

Ceven requires API credentials generated specifically from the Polymarket US developer portal. After you complete the mandatory account verification on the Polymarket US platform, you can create your keys. You provide these keys to Ceven through an encrypted secret store. The agent uses these credentials to sign requests and authenticate your identity when performing read or write actions. We never share these keys with other users or external services. You can rotate your keys at any time in the developer dashboard, which will require a quick update in your Ceven connection settings to restore workflow functionality.
No. This specific integration is built exclusively for Polymarket US, which is the CFTC compliant product for users located in the United States. The global Polymarket app uses a different infrastructure and API set that is not supported by this toolkit. If you attempt to use credentials from the global app, the API calls will fail with an authentication error. Ensure you are using an account verified specifically for the US product and that your API keys were generated at the developers subdomain of the US site to ensure your workflows run without interruption.
Ceven tracks order state through the Get Order and Get Open Orders actions. If an order is partially filled, the remaining quantity stays active in the order book. When you use a cancel action, only the remaining unfilled portion is removed. The filled portion remains as a position in your portfolio. You can build a workflow that monitors these partial fills and automatically submits new orders to complete the desired position size or adjusts the price to match current market movement using the best bid and offer data.
Yes. The Polymarket US API has specific batch limits and rate limits to ensure platform stability. For example, the Create Multiple Orders action allows up to 20 orders in a single request. If your workflow attempts to exceed these limits or sends requests too rapidly, the API will return a rate limit error. Ceven manages this by implementing a retry logic with exponential backoff, but for very high frequency strategies, you should design your workflows to group orders into batches of 20 or less to avoid hitting these thresholds.
The agent uses a combination of Get Market BBO and Get Market Book. For simple trades, it looks at the best bid and offer to find the current market price. For larger trades where the order size might move the market, the agent analyzes the full order book to calculate the average fill price and estimated slippage. You can configure your workflow to only execute a trade if the slippage is below a certain percentage, ensuring that you do not accidentally pay too much for a position during periods of low liquidity.
Yes. By using the Get Market Settlement action, the agent can pull the final resolution and settlement details for any closed or resolved market. This is particularly useful for post trade analysis and performance tracking. You can set up a weekly report that scans your closed positions, pulls the settlement data from Polymarket US, and calculates your total profit or loss. This data can then be pushed to a spreadsheet or a database to track your prediction accuracy over time without manual data entry.
Absolutely. The agent can use List Markets and List Tags to discover new opportunities. For instance, you can create a workflow that searches for any new markets tagged with sports or politics every hour. When a new market is found that matches your criteria, the agent can pull the initial order book and notify you via email or message. This allows you to be among the first to trade on a new event before the market becomes efficient, giving you a programmatic edge over manual traders who check the app occasionally.
A subject slug is a unique, human readable identifier for a person, team, or entity, such as a specific politician or a sports team. Many Polymarket US actions require this slug to filter markets accurately. Instead of guessing a numeric ID, the agent uses List Subjects to find the correct slug first. This ensures that when you ask to trade on a specific candidate, the agent is interacting with the exact entity record recognized by the exchange, preventing errors that could lead to placing trades in the wrong market.

Alternatives to Polymarket US

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

PredictIt logoPredictItKalshi logoKalshiManifold Markets logoManifold Markets

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Polymarket US and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free