Exceeding a rate limit returns 429 Too Many Requests. Limits are enforced per source IP and Cloudflare location, so requests using different API keys from the same IP share counters at that location.
During periods of increased latency, Polymarket US applies a 5-second stopgap to inbound orders. If an order has been received by Polymarket US but has not been processed within 5 seconds, we reject it to protect you from a bad fill at a stale price.
These rejects carry the message Global Rate Limit Exceeded, but they are not an actual rate limit. You do not need to throttle your traffic in response to them. Treat them as a transient latency reject, not a signal to back off.
What it applies to:
New orders — rejected if not processed within 5 seconds.
Order modifications via cancel/replace — also subject to the stopgap.
Pure cancels are not affected — a standalone cancel is never rejected by this stopgap.
You can always cancel an order before you have received an acknowledgement, and even before it has been processed.
The single most effective way to stay within limits is to stop polling and use WebSocket streams. One persistent connection replaces hundreds of repeated REST calls.
Include which endpoints you need higher limits for
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Polymarket US Documentation","colors":{"primary":"#165DFC","light":"#165DFC","dark":"#165DFC"},"logo":{"light":"https://mintcdn.com/polymarketusdocs/NN49MNZwHafQdUcP/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=NN49MNZwHafQdUcP\u0026q=85\u0026s=31d6284cd801a07214abb060e79928e4","dark":"https://mintcdn.com/polymarketusdocs/NN49MNZwHafQdUcP/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=NN49MNZwHafQdUcP\u0026q=85\u0026s=5a708086de6cea6b0d2e06113cb3d890"},"favicon":"https://mintcdn.com/polymarketusdocs/evzbz56sXnnj2zm_/favicon.svg?fit=max\u0026auto=format\u0026n=evzbz56sXnnj2zm_\u0026q=85\u0026s=c10a861ca59caafabd100b8975cc0b5c","background":{"color":{"light":"#FFFFFF","dark":"#0A0B0D"}},"navbar":{"links":[{"icon":"signal","href":"https://status.polymarketexchange.com","label":"System Status"},{"icon":"discord","href":"https://discord.gg/cA6Skf5wCk","label":"Join Discord"}],"primary":{"type":"button","label":"Main Site","href":"https://polymarket.us"}},"footer":{"socials":{"x":"https://x.com/polymarket","linkedin":"https://www.linkedin.com/company/polymarket","discord":"https://discord.gg/cA6Skf5wCk"},"links":[{"header":"Polymarket","items":[{"label":"Careers","href":"https://polymarket.com/careers"},{"label":"Polymarket International","href":"https://polymarket.com"}]},{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://polymarket.us/privacy"},{"label":"Terms of Service","href":"https://polymarket.us/tos"},{"label":"Market Integrity","href":"https://integrity.polymarket.us/"},{"label":"System Status","href":"https://status.polymarketexchange.com"},{"label":"Polymarket Exchange","href":"https://polymarketexchange.com/"},{"label":"Polymarket Clearing","href":"https://polymarketclearing.com/"}]}]},"fonts":{"family":"Inter"},"styling":{"eyebrows":"breadcrumbs","latex":false},"banner":{"content":"You are viewing documentation for Polymarket US","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":true},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"polymarketusdocs","hasAudioNarration":false,"actualSubdomain":"polymarketusdocs","customDomains":["docs.polymarket.us"],"gitSource":{"type":"github","owner":"polymarket","repo":"website-isv-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae37e6226581b3df46dc944","collectionId":"72ac56dd-5cd8-4f97-8f48-1437f52dabe9","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae37e6226581b3df46dc944"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae37e6226581b3df46dc944","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Institutional API","count":120},{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"REST API","count":64},{"language":"default","tag":"App Users","count":47},{"language":"default","tag":"RFQs","count":42},{"language":"default","tag":"Partner Integration","count":29},{"language":"default","tag":"Trading","count":28},{"language":"default","tag":"FIX API","count":23},{"language":"default","tag":"SDKs","count":21},{"language":"default","tag":"Guide","count":21}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"type":"link","url":"http://polymarket.us/support"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#content-container table{table-layout:auto}#content-container table td,#content-container table th{min-width:0!important}#content-container table td code,#content-container table td[data-numeric=true],#content-container table th code{white-space:nowrap}.rewards-cta .card{background:#165dfc!important;border-color:transparent!important}.rewards-cta .card:hover{background:#1253e0!important;border-color:transparent!important}.rewards-cta .card [data-component-part=card-title]{color:#fff!important}.rewards-cta .card [data-component-part=card-content]{color:rgb(255 255 255/.85)!important}.rewards-cta .card [data-component-part=card-icon] svg{background-color:#fff!important}.rewards-cta .card #card-link-arrow-icon{color:rgb(255 255 255/.8)!important}"}],"page":{"pagePath":"api-reference/rate-limits","slug":"/api-reference/rate-limits","pageMetadata":{"title":"Rate Limits","description":"API rate limits and how to stay within them.","href":"/api-reference/rate-limits"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"API rate limits and how to stay within them.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Exceeding a rate limit returns `,_jsx(_components.code,{children:`429 Too Many Requests`}),`. Limits are enforced per source IP and Cloudflare location, so requests using different API keys from the same IP share counters at that location.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`limits`,children:`Limits`}),`\n`,_jsxs(_components.p,{children:[`The Retail API has a general limit of `,_jsx(_components.strong,{children:`25 requests/s`}),`, shared across endpoints except quote creation and deletion.`]}),`\n`,_jsx(_components.p,{children:`Exceptions:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /v1/combos`}),` and `,_jsx(_components.code,{children:`POST /v1/rfqs`}),`: `,_jsx(_components.strong,{children:`1 request/s`}),`, shared.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`POST /v1/rfqs/quotes`}),`: `,_jsx(_components.strong,{children:`100 requests/s`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`DELETE /v1/rfqs/{rfqId}/quotes/{quoteId}`}),`: `,_jsx(_components.strong,{children:`100 requests/s`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/rfqs`}),`: `,_jsx(_components.strong,{children:`1 request/s`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/rfqs/quotes`}),`: `,_jsx(_components.strong,{children:`1 request/s`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/rfqs/trades`}),`: `,_jsx(_components.strong,{children:`1 request/s`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`GET /v1/rfqs/user-id`}),`: `,_jsx(_components.strong,{children:`1 request/s`}),`.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`when-you’re-rate-limited`,children:`When you’re rate limited`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`429`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Too Many Requests\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Stop immediately, wait at least 1 second, then retry with exponential backoff:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` time`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` make_request_with_retry`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`fn`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`max_retries`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` for`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` attempt `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`in`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` range`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(max_retries):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` fn()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.status_code `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 429`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` time.sleep(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` **`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` attempt)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` raise`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` Exception`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Max retries exceeded\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`latency-stopgap-on-orders`,children:`Latency stopgap on orders`}),`\n`,_jsxs(_components.p,{children:[`During periods of increased latency, Polymarket US applies a `,_jsx(_components.strong,{children:`5-second stopgap`}),` to inbound orders. If an order has been received by Polymarket US but has not been processed within 5 seconds, we reject it to protect you from a bad fill at a stale price.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`These rejects carry the message `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`Global Rate Limit Exceeded`})}),`, but they are `,_jsx(_components.strong,{children:`not`}),` an actual rate limit. You do `,_jsx(_components.strong,{children:`not`}),` need to throttle your traffic in response to them. Treat them as a transient latency reject, not a signal to back off.`]})}),`\n`,_jsx(_components.p,{children:`What it applies to:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`New orders`}),` — rejected if not processed within 5 seconds.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Order modifications via cancel/replace`}),` — also subject to the stopgap.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pure cancels are not affected`}),` — a standalone cancel is never rejected by this stopgap.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`You can always cancel an order before you have received an acknowledgement, and even before it has been processed.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`use-websocket-instead-of-polling`,children:`Use WebSocket instead of polling`}),`\n`,_jsx(_components.p,{children:`The single most effective way to stay within limits is to stop polling and use WebSocket streams. One persistent connection replaces hundreds of repeated REST calls.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Don’t poll`}),_jsx(_components.th,{children:`Use instead`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`GET /v1/orders/open`}),` repeatedly`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`/v1/ws/private`}),` - `,_jsx(_components.code,{children:`SUBSCRIPTION_TYPE_ORDER`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`GET /v1/portfolio/positions`}),` repeatedly`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`/v1/ws/private`}),` - `,_jsx(_components.code,{children:`SUBSCRIPTION_TYPE_POSITION`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`GET /v1/account/balances`}),` repeatedly`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`/v1/ws/private`}),` - `,_jsx(_components.code,{children:`SUBSCRIPTION_TYPE_ACCOUNT_BALANCE`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`GET /v1/markets/{slug}/bbo`}),` repeatedly`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`/v1/ws/markets`}),` - `,_jsx(_components.code,{children:`SUBSCRIPTION_TYPE_MARKET_DATA_LITE`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`GET /v1/markets/{slug}/book`}),` repeatedly`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`/v1/ws/markets`}),` - `,_jsx(_components.code,{children:`SUBSCRIPTION_TYPE_MARKET_DATA`})]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`cache-reference-data`,children:`Cache reference data`}),`\n`,_jsx(_components.p,{children:`Market and event metadata changes infrequently. Fetch it once on startup and refresh periodically rather than on every request.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`21`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`21`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` time`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`class`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:` MarketCache`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` def`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` __init__`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`client`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ttl`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`300`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._cache `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._ttl `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ttl`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._last_refresh `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` None`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` get`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`slug`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._needs_refresh():`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._refresh()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._cache.get(slug)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` _needs_refresh`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` not`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._last_refresh `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`or`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (time.time() `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`-`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._last_refresh) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._ttl`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` def`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` _refresh`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`):`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` markets `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._client.markets.list({`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"limit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"active\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`True`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`})`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._cache `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {m[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"slug\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]: m `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`for`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` m `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`in`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` markets[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"markets\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`._last_refresh `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` time.time()`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`for-automated-systems`,children:`For automated systems`}),`\n`,_jsx(_components.p,{children:`If you’re running an automated trading system and need higher limits for production:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Document your use case and expected request volume`}),`\n`,_jsxs(_components.li,{children:[`Email `,_jsx(_components.a,{href:`mailto:support@polymarket.us`,children:`support@polymarket.us`})]}),`\n`,_jsx(_components.li,{children:`Include which endpoints you need higher limits for`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Rate Limits","description":"API rate limits and how to stay within them.","href":"/api-reference/rate-limits"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Limits","slug":"limits","depth":2,"children":[]},{"title":"When you’re rate limited","slug":"when-you’re-rate-limited","depth":2,"children":[]},{"title":"Latency stopgap on orders","slug":"latency-stopgap-on-orders","depth":2,"children":[]},{"title":"Use WebSocket instead of polling","slug":"use-websocket-instead-of-polling","depth":2,"children":[]},{"title":"Cache reference data","slug":"cache-reference-data","depth":2,"children":[]},{"title":"For automated systems","slug":"for-automated-systems","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"polymarketusdocs","siteName":"Polymarket US Documentation","title":"Rate Limits - Polymarket US Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-02T15:03:36.939Z","originalFileLocation":"api-reference/rate-limits.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"API rate limits and how to stay within them.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Polymarket US Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Rate Limits - Polymarket US Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"API rate limits and how to stay within them.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Polymarket US Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.polymarket.us/api-reference/rate-limits\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://polymarketusdocs.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Rate+Limits\u0026amp;description=API+rate+limits+and+how+to+stay+within+them.\u0026amp;theme=258f311544a75bb798e8b1d2\u0026amp;signature=291800ed1a188d03fa55ee02d45ffd2de57f160ead3ddc79006e2fb92e8a78df\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Rate Limits - Polymarket US Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"API rate limits and how to stay within them.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://polymarketusdocs.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Rate+Limits\u0026amp;description=API+rate+limits+and+how+to+stay+within+them.\u0026amp;theme=258f311544a75bb798e8b1d2\u0026amp;signature=291800ed1a188d03fa55ee02d45ffd2de57f160ead3ddc79006e2fb92e8a78df\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/polymarketusdocs/YN7ghhSTLd6PklJ-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Polymarket US Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#165DFC\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.polymarket.us/api-reference/rate-limits\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/rate-limits.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.polymarket.us/#organization\",\"name\":\"Polymarket US Documentation\",\"url\":\"https://docs.polymarket.us\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/polymarketusdocs/NN49MNZwHafQdUcP/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=NN49MNZwHafQdUcP\u0026q=85\u0026s=31d6284cd801a07214abb060e79928e4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.polymarket.us#website\",\"name\":\"Polymarket US Documentation\",\"url\":\"https://docs.polymarket.us\",\"publisher\":{\"@id\":\"https://docs.polymarket.us/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.polymarket.us/api-reference/rate-limits#webpage\",\"url\":\"https://docs.polymarket.us/api-reference/rate-limits\",\"name\":\"Rate Limits\",\"description\":\"API rate limits and how to stay within them.\",\"dateModified\":\"2026-10-02T15:03:36.939Z\",\"isPartOf\":{\"@id\":\"https://docs.polymarket.us#website\"},\"breadcrumb\":{\"@id\":\"https://docs.polymarket.us/api-reference/rate-limits#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.polymarket.us/api-reference/rate-limits#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://docs.polymarket.us/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Rate Limits\",\"item\":\"https://docs.polymarket.us/api-reference/rate-limits\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.polymarket.us/api-reference/rate-limits#article\",\"headline\":\"Rate Limits\",\"name\":\"Rate Limits\",\"description\":\"API rate limits and how to stay within them.\",\"url\":\"https://docs.polymarket.us/api-reference/rate-limits\",\"mainEntityOfPage\":{\"@id\":\"https://docs.polymarket.us/api-reference/rate-limits#webpage\"},\"dateModified\":\"2026-10-02T15:03:36.939Z\",\"publisher\":{\"@id\":\"https://docs.polymarket.us/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.polymarket.us#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Polymarket US Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Polymarket US Documentation","nav":{"global":{},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/welcome"}]},{"tab":"App Users","pages":[{"title":"App Users","href":"/learn/home"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","description":"How to get API keys and make authenticated requests.","href":"/api-reference/authentication"},{"title":"Rate Limits","href":"/api-reference/rate-limits"}]},{"group":"Orders","pages":[{"title":"Orders API Overview","description":"Create, cancel, and manage orders","href":"/api-reference/orders/overview"},{"title":"Get Open Orders","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json get /v1/orders/open","href":"/api-reference/orders/get-open-orders"},{"title":"Get Order","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json get /v1/order/{orderId}","href":"/api-reference/orders/get-order"},{"title":"Create Order","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json post /v1/orders","href":"/api-reference/orders/create-order"},{"title":"Cancel All Open Orders","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json post /v1/orders/open/cancel","href":"/api-reference/orders/cancel-all-open-orders"},{"title":"Cancel Order","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json post /v1/order/{orderId}/cancel","href":"/api-reference/orders/cancel-order"},{"title":"Modify Order","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json post /v1/order/{orderId}/modify","href":"/api-reference/orders/modify-order"},{"title":"Preview Order","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json post /v1/order/preview","href":"/api-reference/orders/preview-order"},{"title":"Close Position Order","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json post /v1/order/close-position","href":"/api-reference/orders/close-position-order"},{"title":"Create Multiple Orders","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json post /v1/orders/batched","href":"/api-reference/orders/create-multiple-orders"},{"title":"Cancel Multiple Orders","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json post /v1/orders/batched/cancel","href":"/api-reference/orders/cancel-multiple-orders"},{"title":"Modify Multiple Orders","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/orders-schema.json post /v1/orders/batched/modify","href":"/api-reference/orders/modify-multiple-orders"}]},{"group":"Combos","pages":[{"title":"Combos API Overview","href":"/api-reference/combos/overview"},{"group":"Combos","pages":[{"title":"Get combos","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/combos-schema.json get /v1/combos","href":"/api-reference/combos/get-combos"},{"title":"Create combo","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/combos-schema.json post /v1/combos","href":"/api-reference/combos/create-combo"}]}]},{"group":"RFQs","pages":[{"title":"RFQ API Overview","href":"/api-reference/rfqs/overview"},{"group":"RFQs","pages":[{"title":"Get RFQs","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json get /v1/rfqs","href":"/api-reference/rfqs/get-rfqs"},{"title":"Create RFQ","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json post /v1/rfqs","href":"/api-reference/rfqs/create-rfq"},{"title":"Get quotes","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json get /v1/rfqs/quotes","href":"/api-reference/rfqs/get-quotes"},{"title":"Create quote","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json post /v1/rfqs/quotes","href":"/api-reference/rfqs/create-quote"},{"title":"Get RFQ trades","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json get /v1/rfqs/trades","href":"/api-reference/rfqs/get-rfq-trades"},{"title":"Get RFQ user ID","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json get /v1/rfqs/user-id","href":"/api-reference/rfqs/get-rfq-user-id"},{"title":"Delete RFQ","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json delete /v1/rfqs/{rfqId}","href":"/api-reference/rfqs/delete-rfq"},{"title":"Delete quote","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json delete /v1/rfqs/{rfqId}/quotes/{quoteId}","href":"/api-reference/rfqs/delete-quote"},{"title":"Accept quote","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json put /v1/rfqs/{rfqId}/quotes/{quoteId}/accept","href":"/api-reference/rfqs/accept-quote"},{"title":"Confirm quote","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/rfqs-schema.json put /v1/rfqs/{rfqId}/quotes/{quoteId}/confirm","href":"/api-reference/rfqs/confirm-quote"}]}]},{"group":"Portfolio","pages":[{"title":"Portfolio API Overview","href":"/api-reference/portfolio/overview"},{"title":"Get User Positions","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/portfolio-schema.json get /v1/portfolio/positions","href":"/api-reference/portfolio/get-user-positions"},{"title":"Get Activities","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/portfolio-schema.json get /v1/portfolio/activities","href":"/api-reference/portfolio/get-activities"},{"title":"Get Account Balances","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/portfolio-schema.json get /v1/account/balances","href":"/api-reference/account/get-account-balances"}]},{"group":"Events","pages":[{"title":"Events API Overview","href":"/api-reference/events/overview"},{"title":"Get Events","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/events-schema.json get /v1/events","href":"/api-reference/events/get-events"},{"title":"Get Event By Slug","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/events-schema.json get /v1/events/slug/{slug}","href":"/api-reference/events/get-event-by-slug"},{"title":"Get Event By ID","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/events-schema.json get /v1/events/{id}","href":"/api-reference/events/get-event-by-id"},{"title":"Get Event By Partner External ID","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/events-schema.json get /v1/partners/{partnerKey}/events/{externalId}","href":"/api-reference/partners/get-event-by-partner-external-id"}]},{"group":"Markets","pages":[{"title":"Markets API Overview","href":"/api-reference/market/overview"},{"title":"Get Price History","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/price-history-schema.json get /v1/price-history","href":"/api-reference/price-history/get-price-history"},{"title":"Get Market By ID","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/markets-schema.json get /v1/market/id/{id}","href":"/api-reference/markets/get-market-by-id"},{"title":"Get Market By Slug","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/markets-schema.json get /v1/market/slug/{slug}","href":"/api-reference/markets/get-market-by-slug"},{"title":"Get Markets","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/markets-schema.json get /v1/markets","href":"/api-reference/markets/get-markets"},{"title":"Get Market BBO","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/markets-schema.json get /v1/markets/{slug}/bbo","href":"/api-reference/markets/get-market-bbo"},{"title":"Get Market Book","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/markets-schema.json get /v1/markets/{slug}/book","href":"/api-reference/markets/get-market-book"},{"title":"Get Market Settlement","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/markets-schema.json get /v1/markets/{slug}/settlement","href":"/api-reference/markets/get-market-settlement"}]},{"group":"Asset Prices","pages":[{"title":"Asset Prices API Overview","href":"/api-reference/asset-prices/overview"},{"title":"Get A Bucketed OHLC Price Series For One Or More Assets","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/asset-prices-schema.json get /v1/asset-prices/history","href":"/api-reference/asset-prices/get-a-bucketed-ohlc-price-series-for-one-or-more-assets"}]},{"group":"Series","pages":[{"title":"Series API Overview","href":"/api-reference/series/overview"},{"title":"Get Series","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/series-schema.json get /v1/series","href":"/api-reference/series/get-series"},{"title":"Get Series By ID","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/series-schema.json get /v1/series/id/{id}","href":"/api-reference/series/get-series-by-id"}]},{"group":"Sports","pages":[{"title":"Sports API Overview","href":"/api-reference/sports/overview"},{"title":"Get All Leagues","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-schema.json get /v2/leagues","href":"/api-reference/sports/get-all-leagues"},{"title":"Get League By Slug","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-schema.json get /v2/leagues/{slug}","href":"/api-reference/sports/get-league-by-slug"},{"title":"Get Events By League Slug","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-schema.json get /v2/leagues/{slug}/events","href":"/api-reference/sports/get-events-by-league-slug"},{"title":"Get All Sports","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-schema.json get /v2/sports","href":"/api-reference/sports/get-all-sports"},{"title":"Get Sport By Slug","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-schema.json get /v2/sports/{slug}","href":"/api-reference/sports/get-sport-by-slug"},{"title":"Get Events By Sport Slug","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-schema.json get /v2/sports/{slug}/events","href":"/api-reference/sports/get-events-by-sport-slug"}]},{"group":"Sports (Legacy)","pages":[{"title":"Sports API Overview (Legacy)","href":"/api-reference/sports-legacy/overview"},{"title":"Get Sports","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-legacy-schema.json get /v1/sports","href":"/api-reference/sports/get-sports"},{"title":"Get Sports Players","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-legacy-schema.json get /v1/sports/players","href":"/api-reference/sports/get-sports-players"},{"title":"Get Sports Teams","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-legacy-schema.json get /v1/sports/teams","href":"/api-reference/sports/get-sports-teams"},{"title":"Get Sports Teams For Provider","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-legacy-schema.json get /v1/sports/teams/provider","href":"/api-reference/sports/get-sports-teams-for-provider"},{"title":"Get Sports Events","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/sports-legacy-schema.json get /v1/sports/{seriesId}/events","href":"/api-reference/sports/get-sports-events"}]},{"group":"Tags","pages":[{"title":"Tags API Overview","href":"/api-reference/tags/overview"},{"title":"Get Tags","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/tags-schema.json get /v2/tags","href":"/api-reference/tags/get-tags"},{"title":"Get Tag By Slug","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/tags-schema.json get /v2/tags/slug/{slug}","href":"/api-reference/tags/get-tag-by-slug"},{"title":"Get Tag By ID","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/tags-schema.json get /v2/tags/{id}","href":"/api-reference/tags/get-tag-by-id"},{"title":"Get Events For A Tag","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/tags-schema.json get /v2/tags/{slug}/events","href":"/api-reference/tags/get-events-for-a-tag"}]},{"group":"Search","pages":[{"title":"Search API Overview","href":"/api-reference/search/overview"},{"title":"Search","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/search-schema.json get /v1/search","href":"/api-reference/search/search"}]},{"group":"Incentives","pages":[{"title":"Incentives API Overview","href":"/api-reference/incentives/overview"},{"title":"Get Incentive Programs","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/incentives-schema.json get /v1/incentives","href":"/api-reference/incentives/get-incentive-programs"},{"title":"Get Your Incentive Earnings","deprecated":null,"version":null,"openapi":"/api-reference/oapi-schemas/incentives-schema.json get /v1/incentives/earnings","href":"/api-reference/incentives/get-your-incentive-earnings"}]}]},{"tab":"WebSockets","pages":[{"title":"WebSockets","href":"/api-reference/websocket/overview"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/api-reference/sdks/introduction"}]},{"tab":"Institutional API","pages":[{"title":"Institutional API","href":"/trader-guide/overview"}]},{"tab":"Incentives","pages":[{"title":"Incentives","href":"/incentives/overview"}]},{"tab":"Fees \u0026 Rebates","pages":[{"title":"Fees \u0026 Rebates","href":"/fees"}]},{"tab":"Data","pages":[{"title":"Data","href":"/data-guide/overview"}]},{"tab":"Partner Integration","pages":[{"title":"Partner Integration","href":"/partners/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Rate Limits - Polymarket US Documentation","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":[],"chunks":[]}