The Polymarket US API is split into two parts: an authenticated API for trading and a public API for reading market data. For support, contact support@polymarket.us.
Use the authenticated API to trade. This is where you place orders, check your positions, and manage your account. Every request requires an API key - see Authentication to get set up.
Group
What you get
Orders
Place, modify, cancel, and query orders
Portfolio
View positions and trading activity
Account
Check balances and buying power
The authenticated API also provides two WebSocket endpoints for real-time streaming:
Use the public API to browse what’s available on Polymarket US. No API key needed. This is where you fetch markets, events, series, sports data, and search results. If you’re building something that displays market information - prices, odds, order books - this is all you need.
Group
What you get
Markets
List markets, get order books, BBO, settlement prices, and price history
Events
List events, get event details
Series
List series (e.g., NFL 2025-26 Season)
Sports
Leagues, teams, game schedules
Search
Full-text search across events and markets
{"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":"6ae23ea14fcea78db1a91d35","collectionId":"0892a130-af78-4bf1-8add-dbacd67edd19","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae23ea14fcea78db1a91d35"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae23ea14fcea78db1a91d35","clientVersion":"0.0.4006","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":"editor-v7-file-tree","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":"editor-nav-generations","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":"editor-agent-model-picker","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/introduction","slug":"/api-reference/introduction","pageMetadata":{"title":"Introduction","description":"Overview of the Polymarket US API","href":"/api-reference/introduction"},"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: \"Overview of the Polymarket US API\"\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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Polymarket US API is split into two parts: an authenticated API for trading and a public API for reading market data. For support, contact `,_jsx(_components.a,{href:`mailto:support@polymarket.us`,children:`support@polymarket.us`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`authenticated-api`,children:`Authenticated API`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://api.polymarket.us`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Use the authenticated API to trade. This is where you place orders, check your positions, and manage your account. Every request requires an API key - see `,_jsx(_components.a,{href:`/api-reference/authentication`,children:`Authentication`}),` to get set up.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Group`}),_jsx(_components.th,{children:`What you get`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Orders`})}),_jsx(_components.td,{children:`Place, modify, cancel, and query orders`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Portfolio`})}),_jsx(_components.td,{children:`View positions and trading activity`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Account`})}),_jsx(_components.td,{children:`Check balances and buying power`})]})]})]}),`\n`,_jsx(_components.p,{children:`The authenticated API also provides two WebSocket endpoints for real-time streaming:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Purpose`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`wss://api.polymarket.us/v1/ws/private`})}),_jsx(_components.td,{children:`Real-time order, position, and balance updates`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`wss://api.polymarket.us/v1/ws/markets`})}),_jsx(_components.td,{children:`Real-time order book and trade streaming`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`public-api`,children:`Public API`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://gateway.polymarket.us`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Use the public API to browse what’s available on Polymarket US. No API key needed. This is where you fetch markets, events, series, sports data, and search results. If you’re building something that displays market information - prices, odds, order books - this is all you need.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Group`}),_jsx(_components.th,{children:`What you get`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Markets`})}),_jsx(_components.td,{children:`List markets, get order books, BBO, settlement prices, and price history`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Events`})}),_jsx(_components.td,{children:`List events, get event details`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Series`})}),_jsx(_components.td,{children:`List series (e.g., NFL 2025-26 Season)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sports`})}),_jsx(_components.td,{children:`Leagues, teams, game schedules`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Search`})}),_jsx(_components.td,{children:`Full-text search across events and markets`})]})]})]})]})}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":"Introduction","description":"Overview of the Polymarket US API","href":"/api-reference/introduction"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authenticated API","slug":"authenticated-api","depth":2,"children":[]},{"title":"Public API","slug":"public-api","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"polymarketusdocs","siteName":"Polymarket US Documentation","title":"Introduction - Polymarket US Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-04T07:21:40.413Z","originalFileLocation":"api-reference/introduction.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=\"Overview of the Polymarket US API\">\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=\"Introduction - Polymarket US Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Overview of the Polymarket US API\">\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/introduction\">\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=Introduction\u0026amp;description=Overview+of+the+Polymarket+US+API\u0026amp;theme=258f311544a75bb798e8b1d2\u0026amp;signature=4d1654b4f3786e2ee6e8f4636fcc0f4f771acbd9400df64e35b3ef8f386bb3af\">\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=\"Introduction - Polymarket US Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Overview of the Polymarket US API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://polymarketusdocs.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Introduction\u0026amp;description=Overview+of+the+Polymarket+US+API\u0026amp;theme=258f311544a75bb798e8b1d2\u0026amp;signature=4d1654b4f3786e2ee6e8f4636fcc0f4f771acbd9400df64e35b3ef8f386bb3af\">\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/introduction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/introduction.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/introduction#webpage\",\"url\":\"https://docs.polymarket.us/api-reference/introduction\",\"name\":\"Introduction\",\"description\":\"Overview of the Polymarket US API\",\"dateModified\":\"2026-09-04T07:21:40.413Z\",\"isPartOf\":{\"@id\":\"https://docs.polymarket.us#website\"},\"breadcrumb\":{\"@id\":\"https://docs.polymarket.us/api-reference/introduction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.polymarket.us/api-reference/introduction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Polymarket US Documentation\",\"item\":\"https://docs.polymarket.us\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introduction\",\"item\":\"https://docs.polymarket.us/api-reference/introduction\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.polymarket.us/api-reference/introduction#article\",\"headline\":\"Introduction\",\"name\":\"Introduction\",\"description\":\"Overview of the Polymarket US API\",\"url\":\"https://docs.polymarket.us/api-reference/introduction\",\"mainEntityOfPage\":{\"@id\":\"https://docs.polymarket.us/api-reference/introduction#webpage\"},\"dateModified\":\"2026-09-04T07:21:40.413Z\",\"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","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":"Introduction - Polymarket US Documentation","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":[],"chunks":[]}