{"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":"6ae0e73a400e864d11fae193","collectionId":"01f350a0-5cec-4ca6-8046-522ecfffdb18","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae0e73a400e864d11fae193"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae0e7b6a716ea245f81c860","clientVersion":"0.0.3990","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}],"isAtlas":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/referencedata/list-instruments","slug":"/api-reference/referencedata/list-instruments","pageMetadata":{"title":"List instruments","description":"Returns a list of instruments matching the request","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/refdata-schema.json post /v1/refdata/instruments","href":"/api-reference/referencedata/list-instruments","autogeneratedByOpenApi":true},"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: \"Returns a list of instruments matching the request\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List instruments","description":"Returns a list of instruments matching the request","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/refdata-schema.json post /v1/refdata/instruments","href":"/api-reference/referencedata/list-instruments","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List instruments","description":"Returns a list of instruments matching the request","operationId":"RefDataAPI_ListInstruments","responses":{"200":"d9175b4b-e5bc-4bd0-a135-548d2fe04f54"},"requestBody":"d4b71f5a-5b50-4370-b054-c6a42f9771a1","tags":["ReferenceData"],"method":"post","type":"path","servers":["822f3171-258b-4925-b140-f6222ccc5095"],"security":["f4ed3174-b7b7-4db2-bc52-9370341828fe"],"path":"/v1/refdata/instruments","baseUrlOptions":["https://api.prod.polymarketexchange.com"],"title":"List instruments","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"pageSize":{"type":"integer","format":"int32","title":"=== Pagination ===","description":"Results per page (default: 50, max: 1000)","uniqueKey":"pageSize","typeLabel":"integer\u003cint32>"},"pageToken":{"type":"string","description":"Pagination cursor from previous response","uniqueKey":"pageToken","typeLabel":"string"},"symbols":{"type":"array","items":{"type":"string","uniqueKey":"symbols.items.[INDEX]","typeLabel":"string"},"title":"=== Existing filters (backwards compatible) ===","description":"Filter by specific instrument symbols","uniqueKey":"symbols","typeLabel":"string[]"},"productId":{"type":"string","description":"Filter by product ID","uniqueKey":"productId","typeLabel":"string"},"tradableFilter":{"type":"string","enum":["TRADABLE_FILTER_NON_TRADABLE","TRADABLE_FILTER_TRADABLE"],"description":"Filter tradable vs non-tradable instruments","uniqueKey":"tradableFilter","typeLabel":"enum\u003cstring>"},"states":{"type":"array","items":{"type":"string","enum":["INSTRUMENT_STATE_OPEN","INSTRUMENT_STATE_PREOPEN","INSTRUMENT_STATE_SUSPENDED","INSTRUMENT_STATE_EXPIRED","INSTRUMENT_STATE_TERMINATED","INSTRUMENT_STATE_HALTED","INSTRUMENT_STATE_MATCH_AND_CLOSE_AUCTION","INSTRUMENT_STATE_PENDING"],"description":"**PENDING**: Initial state for a newly created instrument which has not yet begun trading.\n\n**CLOSED**: No order entry, modification, cancellation, or matching. Day orders expired.\n\n**OPEN**: Continuous order entry and matching.\n\n**PREOPEN**: Orders accepted, no matching. Dutch Auction on transition to OPEN.\n\n**MATCH_AND_CLOSE_AUCTION**: Like PREOPEN, matches on transition out.\n\n**SUSPENDED**: Cancel only. No entry, modification, or matching.\n\n**HALTED**: Like SUSPENDED, no cancels allowed.\n\n**EXPIRED**: All resting orders expired, no new orders.\n\n**TERMINATED**: Order book removed, all orders and positions closed.","uniqueKey":"states.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Filter by instrument states (e.g., INSTRUMENT_STATE_OPEN)","uniqueKey":"states","typeLabel":"enum\u003cstring>[]"},"type":{"type":"string","enum":["INSTRUMENT_TYPE_DEFAULT","INSTRUMENT_TYPE_FUTURE","INSTRUMENT_TYPE_OPTION","INSTRUMENT_TYPE_MULTILEG","INSTRUMENT_TYPE_IRS","INSTRUMENT_TYPE_FRA","INSTRUMENT_TYPE_FSIRS","INSTRUMENT_TYPE_BASIS","INSTRUMENT_TYPE_EVENT","INSTRUMENT_TYPE_OIS","INSTRUMENT_TYPE_SPS","INSTRUMENT_TYPE_NDF","INSTRUMENT_TYPE_FOREX","INSTRUMENT_TYPE_ZCIS","INSTRUMENT_TYPE_XCCY"],"description":"InstrumentType represents the type of instrument.","uniqueKey":"type","typeLabel":"enum\u003cstring>"},"eventSeries":{"type":"string","description":"Filter by event series (e.g., \"cbb\", \"nfl\", \"nba\").\nMatches instruments where metadata[\"event_series\"] equals this value.","uniqueKey":"eventSeries","typeLabel":"string"},"marketCategory":{"type":"string","description":"Filter by market category (e.g., \"sports\", \"politics\", \"crypto\").","uniqueKey":"marketCategory","typeLabel":"string"},"marketType":{"type":"string","description":"Filter by market type (e.g., \"moneyline\", \"spread\", \"over_under\").","uniqueKey":"marketType","typeLabel":"string"},"gameId":{"type":"string","description":"Filter by game ID (provider-specific game identifier).","uniqueKey":"gameId","typeLabel":"string"},"clearingSym":{"type":"string","description":"Filter by clearing symbol prefix (e.g., \"AEC-NFL\", \"AEC-NBA\").","uniqueKey":"clearingSym","typeLabel":"string"},"eventCategory":{"type":"string","description":"Filter by event category (e.g., \"SPR\" for sports, \"POL\" for politics).\nMatches instruments where metadata[\"event_category\"] equals this value.","uniqueKey":"eventCategory","typeLabel":"string"},"startTimeGte":{"type":"string","description":"Filter instruments with start_date >= this value (format: \"2025-01-01\" or timestamp).\nReturns instruments that start on or after this date.","uniqueKey":"startTimeGte","typeLabel":"string"},"startTimeLte":{"type":"string","description":"Filter instruments with start_date \u003c= this value (format: \"2025-01-01\" or timestamp).\nReturns instruments that start on or before this date.","uniqueKey":"startTimeLte","typeLabel":"string"},"endTimeGte":{"type":"string","description":"Filter instruments with expiration_date >= this value (format: \"2025-01-01\" or timestamp).\nReturns instruments that expire on or after this date.","uniqueKey":"endTimeGte","typeLabel":"string"},"endTimeLte":{"type":"string","description":"Filter instruments with expiration_date \u003c= this value (format: \"2025-01-01\" or timestamp).\nReturns instruments that expire on or before this date.","uniqueKey":"endTimeLte","typeLabel":"string"},"filter":{"type":"object","properties":{"whereClause":{"type":"string","title":"SQL WHERE clause fragment (without the WHERE keyword).\nAllowed operators: =, !=, \u003c, \u003c=, >, >=, LIKE, IN, AND, OR, NOT\nAllowed columns: symbol, state, product_id, event_series, event_category, market_category,\n market_type, game_id, clearing_sym, start_date, expiration_date,\n event_id, event_question, event_outcome, non_tradable, tick_size\nExample: \"symbol LIKE 'aec-nfl-%' AND state = 'INSTRUMENT_STATE_OPEN'\"","description":"SQL-like string expression. Supported operators: =, LIKE (with % wildcard), AND. Supported columns: state, symbol, event_series, event_category, clearing_sym, clearing_house, product_id. Do NOT use instrument_product, outcome_type, or event_subcategory (causes HTTP 500).","uniqueKey":"filter.whereClause","typeLabel":"string"},"fieldFilters":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","description":"Column name to filter on.","uniqueKey":"filter.fieldFilters.items.[INDEX].field","typeLabel":"string"},"operator":{"type":"string","enum":["FILTER_OPERATOR_EQ","FILTER_OPERATOR_NE","FILTER_OPERATOR_LT","FILTER_OPERATOR_LE","FILTER_OPERATOR_GT","FILTER_OPERATOR_GE","FILTER_OPERATOR_LIKE","FILTER_OPERATOR_IN","FILTER_OPERATOR_NOT_IN"],"description":"Comparison operator","uniqueKey":"filter.fieldFilters.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"stringValue":{"type":"string","description":"String value to compare against (for EQ, LIKE)","uniqueKey":"filter.fieldFilters.items.[INDEX].stringValue","typeLabel":"string"},"intValue":{"type":"string","format":"int64","uniqueKey":"filter.fieldFilters.items.[INDEX].intValue","typeLabel":"string\u003cint64>"},"doubleValue":{"type":"number","format":"double","uniqueKey":"filter.fieldFilters.items.[INDEX].doubleValue","typeLabel":"number\u003cdouble>"},"stringList":{"type":"object","properties":{"values":{"type":"array","items":{"type":"string","uniqueKey":"filter.fieldFilters.items.[INDEX].stringList.values.items.[INDEX]","typeLabel":"string"},"description":"List of string values","uniqueKey":"filter.fieldFilters.items.[INDEX].stringList.values","typeLabel":"string[]"}},"description":"List of string values (for IN operator)","uniqueKey":"filter.fieldFilters.items.[INDEX].stringList","typeLabel":"object"}},"description":"FieldFilter for structured filtering.","uniqueKey":"filter.fieldFilters.items.[INDEX]","typeLabel":"object"},"description":"Structured type-safe filters (ANDed with where_clause if both provided).","uniqueKey":"filter.fieldFilters","typeLabel":"object[]"}},"description":"Advanced filter with whereClause and/or fieldFilters (ANDed together if both provided)","uniqueKey":"filter","typeLabel":"object"}},"description":"Request for listing instruments.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"pageSize":123,"pageToken":"\u003cstring>","symbols":["\u003cstring>"],"productId":"\u003cstring>","states":[],"eventSeries":"\u003cstring>","marketCategory":"\u003cstring>","marketType":"\u003cstring>","gameId":"\u003cstring>","clearingSym":"\u003cstring>","eventCategory":"\u003cstring>","startTimeGte":"\u003cstring>","startTimeLte":"\u003cstring>","endTimeGte":"\u003cstring>","endTimeLte":"\u003cstring>","filter":{"whereClause":"\u003cstring>","fieldFilters":[{"field":"\u003cstring>","stringValue":"\u003cstring>","intValue":"\u003cstring>","doubleValue":123,"stringList":{"values":["\u003cstring>"]}}]}}}},"exampleType":"generated"}},"description":"Request for listing instruments.","required":true,"exampleType":"generated"},"responses":{"d9175b4b-e5bc-4bd0-a135-548d2fe04f54":{"description":"A successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"instruments":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string","uniqueKey":"instruments.items.[INDEX].symbol","typeLabel":"string"},"tickSize":{"type":"number","format":"double","uniqueKey":"instruments.items.[INDEX].tickSize","typeLabel":"number\u003cdouble>"},"baseCurrency":{"type":"string","uniqueKey":"instruments.items.[INDEX].baseCurrency","typeLabel":"string"},"multiplier":{"type":"number","format":"double","uniqueKey":"instruments.items.[INDEX].multiplier","typeLabel":"number\u003cdouble>"},"minimumTradeQty":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].minimumTradeQty","typeLabel":"string\u003cint64>"},"startDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].startDate.year","typeLabel":"integer\u003cint32>"},"month":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].startDate.month","typeLabel":"integer\u003cint32>"},"day":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].startDate.day","typeLabel":"integer\u003cint32>"}},"description":"Date represents a calendar date.","uniqueKey":"instruments.items.[INDEX].startDate","typeLabel":"object"},"expirationDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].expirationDate.year","typeLabel":"integer\u003cint32>"},"month":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].expirationDate.month","typeLabel":"integer\u003cint32>"},"day":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].expirationDate.day","typeLabel":"integer\u003cint32>"}},"description":"Date represents a calendar date.","uniqueKey":"instruments.items.[INDEX].expirationDate","typeLabel":"object"},"terminationDate":{"type":"object","properties":{"year":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].terminationDate.year","typeLabel":"integer\u003cint32>"},"month":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].terminationDate.month","typeLabel":"integer\u003cint32>"},"day":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].terminationDate.day","typeLabel":"integer\u003cint32>"}},"description":"Date represents a calendar date.","uniqueKey":"instruments.items.[INDEX].terminationDate","typeLabel":"object"},"tradingSchedule":{"type":"array","items":{"type":"object","properties":{"daysOfWeek":{"type":"array","items":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].daysOfWeek.items.[INDEX]","typeLabel":"integer\u003cint32>"},"uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].daysOfWeek","typeLabel":"integer\u003cint32>[]"},"timeOfDay":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].timeOfDay.hours","typeLabel":"integer\u003cint32>"},"minutes":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].timeOfDay.minutes","typeLabel":"integer\u003cint32>"},"seconds":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].timeOfDay.seconds","typeLabel":"integer\u003cint32>"}},"description":"TimeOfDay represents a time of day.","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].timeOfDay","typeLabel":"object"},"duration":{"type":"string","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].duration","typeLabel":"string"},"state":{"type":"string","enum":["INSTRUMENT_STATE_OPEN","INSTRUMENT_STATE_PREOPEN","INSTRUMENT_STATE_SUSPENDED","INSTRUMENT_STATE_EXPIRED","INSTRUMENT_STATE_TERMINATED","INSTRUMENT_STATE_HALTED","INSTRUMENT_STATE_MATCH_AND_CLOSE_AUCTION","INSTRUMENT_STATE_PENDING"],"description":"**PENDING**: Initial state for a newly created instrument which has not yet begun trading.\n\n**CLOSED**: No order entry, modification, cancellation, or matching. Day orders expired.\n\n**OPEN**: Continuous order entry and matching.\n\n**PREOPEN**: Orders accepted, no matching. Dutch Auction on transition to OPEN.\n\n**MATCH_AND_CLOSE_AUCTION**: Like PREOPEN, matches on transition out.\n\n**SUSPENDED**: Cancel only. No entry, modification, or matching.\n\n**HALTED**: Like SUSPENDED, no cancels allowed.\n\n**EXPIRED**: All resting orders expired, no new orders.\n\n**TERMINATED**: Order book removed, all orders and positions closed.","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"hideMarketData":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].hideMarketData","typeLabel":"boolean"},"expireAllOrders":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX].expireAllOrders","typeLabel":"boolean"}},"description":"TradingHours describes an instrument trading schedule segment.","uniqueKey":"instruments.items.[INDEX].tradingSchedule.items.[INDEX]","typeLabel":"object"},"uniqueKey":"instruments.items.[INDEX].tradingSchedule","typeLabel":"object[]"},"description":{"type":"string","uniqueKey":"instruments.items.[INDEX].description","typeLabel":"string"},"clearingHouse":{"type":"string","uniqueKey":"instruments.items.[INDEX].clearingHouse","typeLabel":"string"},"minimumUnaffiliatedFirms":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].minimumUnaffiliatedFirms","typeLabel":"string\u003cint64>"},"nonTradable":{"type":"boolean","title":"type_attributes omitted - complex oneof with many swap types","uniqueKey":"instruments.items.[INDEX].nonTradable","typeLabel":"boolean"},"jsonAttributes":{"type":"string","uniqueKey":"instruments.items.[INDEX].jsonAttributes","typeLabel":"string"},"productId":{"type":"string","uniqueKey":"instruments.items.[INDEX].productId","typeLabel":"string"},"priceLimit":{"type":"object","properties":{"low":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].priceLimit.low","typeLabel":"string\u003cint64>"},"high":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].priceLimit.high","typeLabel":"string\u003cint64>"},"lowSet":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].priceLimit.lowSet","typeLabel":"boolean"},"highSet":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].priceLimit.highSet","typeLabel":"boolean"},"relativeLow":{"type":"number","format":"double","uniqueKey":"instruments.items.[INDEX].priceLimit.relativeLow","typeLabel":"number\u003cdouble>"},"relativeHigh":{"type":"number","format":"double","uniqueKey":"instruments.items.[INDEX].priceLimit.relativeHigh","typeLabel":"number\u003cdouble>"},"relativeLowSet":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].priceLimit.relativeLowSet","typeLabel":"boolean"},"relativeHighSet":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].priceLimit.relativeHighSet","typeLabel":"boolean"}},"description":"PriceLimit describes optional price limits on an instrument.","uniqueKey":"instruments.items.[INDEX].priceLimit","typeLabel":"object"},"orderSizeLimit":{"type":"object","properties":{"low":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].orderSizeLimit.low","typeLabel":"string\u003cint64>"},"high":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].orderSizeLimit.high","typeLabel":"string\u003cint64>"},"lowSet":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].orderSizeLimit.lowSet","typeLabel":"boolean"},"highSet":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].orderSizeLimit.highSet","typeLabel":"boolean"},"totalNotionalLow":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].orderSizeLimit.totalNotionalLow","typeLabel":"string\u003cint64>"},"totalNotionalHigh":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].orderSizeLimit.totalNotionalHigh","typeLabel":"string\u003cint64>"},"totalNotionalLowSet":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].orderSizeLimit.totalNotionalLowSet","typeLabel":"boolean"},"totalNotionalHighSet":{"type":"boolean","uniqueKey":"instruments.items.[INDEX].orderSizeLimit.totalNotionalHighSet","typeLabel":"boolean"}},"description":"OrderSizeLimit describes optional order size limits on an instrument.","uniqueKey":"instruments.items.[INDEX].orderSizeLimit","typeLabel":"object"},"expirationTime":{"type":"object","properties":{"hours":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].expirationTime.hours","typeLabel":"integer\u003cint32>"},"minutes":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].expirationTime.minutes","typeLabel":"integer\u003cint32>"},"seconds":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].expirationTime.seconds","typeLabel":"integer\u003cint32>"}},"description":"TimeOfDay represents a time of day.","uniqueKey":"instruments.items.[INDEX].expirationTime","typeLabel":"object"},"tradeSettlementPeriod":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].tradeSettlementPeriod","typeLabel":"string\u003cint64>"},"state":{"type":"string","enum":["INSTRUMENT_STATE_OPEN","INSTRUMENT_STATE_PREOPEN","INSTRUMENT_STATE_SUSPENDED","INSTRUMENT_STATE_EXPIRED","INSTRUMENT_STATE_TERMINATED","INSTRUMENT_STATE_HALTED","INSTRUMENT_STATE_MATCH_AND_CLOSE_AUCTION","INSTRUMENT_STATE_PENDING"],"description":"**PENDING**: Initial state for a newly created instrument which has not yet begun trading.\n\n**CLOSED**: No order entry, modification, cancellation, or matching. Day orders expired.\n\n**OPEN**: Continuous order entry and matching.\n\n**PREOPEN**: Orders accepted, no matching. Dutch Auction on transition to OPEN.\n\n**MATCH_AND_CLOSE_AUCTION**: Like PREOPEN, matches on transition out.\n\n**SUSPENDED**: Cancel only. No entry, modification, or matching.\n\n**HALTED**: Like SUSPENDED, no cancels allowed.\n\n**EXPIRED**: All resting orders expired, no new orders.\n\n**TERMINATED**: Order book removed, all orders and positions closed.","uniqueKey":"instruments.items.[INDEX].state","typeLabel":"enum\u003cstring>"},"priceScale":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].priceScale","typeLabel":"string\u003cint64>"},"fractionalQtyScale":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].fractionalQtyScale","typeLabel":"string\u003cint64>"},"settlementCurrency":{"type":"string","uniqueKey":"instruments.items.[INDEX].settlementCurrency","typeLabel":"string"},"settlementPriceScale":{"type":"string","format":"int64","uniqueKey":"instruments.items.[INDEX].settlementPriceScale","typeLabel":"string\u003cint64>"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"instruments.items.[INDEX].metadata.additionalProperties","typeLabel":"string"},"description":"Per-instrument metadata from the exchange Attributes.Metadata map.\nContains sports metadata like game_id, team abbreviations, league, etc.","uniqueKey":"instruments.items.[INDEX].metadata","typeLabel":"object"},"eventAttributes":{"type":"object","properties":{"question":{"type":"string","description":"The question or description of the event outcome.","uniqueKey":"instruments.items.[INDEX].eventAttributes.question","typeLabel":"string"},"payoutValue":{"type":"string","description":"The payout value when the event resolves (e.g., \"1000\").","uniqueKey":"instruments.items.[INDEX].eventAttributes.payoutValue","typeLabel":"string"},"evaluationType":{"type":"string","description":"The evaluation type for resolution (e.g., \">\", \"\u003c\", \"=\").","uniqueKey":"instruments.items.[INDEX].eventAttributes.evaluationType","typeLabel":"string"},"eventId":{"type":"string","description":"Unique event identifier.","uniqueKey":"instruments.items.[INDEX].eventAttributes.eventId","typeLabel":"string"},"eventDisplayName":{"type":"string","description":"Human-readable display name for the event.","uniqueKey":"instruments.items.[INDEX].eventAttributes.eventDisplayName","typeLabel":"string"},"strikeValue":{"type":"string","description":"Strike value for evaluation.","uniqueKey":"instruments.items.[INDEX].eventAttributes.strikeValue","typeLabel":"string"},"strikeUnit":{"type":"string","description":"Unit for strike value (e.g., \"decimal\", \"percentage\").","uniqueKey":"instruments.items.[INDEX].eventAttributes.strikeUnit","typeLabel":"string"},"calculationMethod":{"type":"string","description":"Calculation method for settlement.","uniqueKey":"instruments.items.[INDEX].eventAttributes.calculationMethod","typeLabel":"string"},"positionAccountabilityValue":{"type":"string","description":"Position accountability limit value.","uniqueKey":"instruments.items.[INDEX].eventAttributes.positionAccountabilityValue","typeLabel":"string"},"timeSpecifier":{"type":"object","properties":{"year":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].eventAttributes.timeSpecifier.year","typeLabel":"integer\u003cint32>"},"month":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].eventAttributes.timeSpecifier.month","typeLabel":"integer\u003cint32>"},"day":{"type":"integer","format":"int32","uniqueKey":"instruments.items.[INDEX].eventAttributes.timeSpecifier.day","typeLabel":"integer\u003cint32>"}},"description":"Time specifier for the event","uniqueKey":"instruments.items.[INDEX].eventAttributes.timeSpecifier","typeLabel":"object"},"eventOutcome":{"type":"string","description":"The relationship of instrument outcomes within the event:\n\"EVENT_OUTCOME_MUTUALLY_EXCLUSIVE\" (exactly one instrument in the event resolves YES),\n\"EVENT_OUTCOME_DIRECTIONAL\" (instruments are strike-ranked; YES at one strike implies\nYES for in-the-money strikes), or \"EVENT_OUTCOME_INDEPENDENT\" (each instrument resolves\non its own; also the default when the exchange has not set an outcome type).","uniqueKey":"instruments.items.[INDEX].eventAttributes.eventOutcome","typeLabel":"string"}},"description":"EventAttributes contains event-specific instrument attributes.","uniqueKey":"instruments.items.[INDEX].eventAttributes","typeLabel":"object"},"createTime":{"type":"string","format":"date-time","description":"Creation timestamp of the instrument.","uniqueKey":"instruments.items.[INDEX].createTime","typeLabel":"string\u003cdate-time>"},"updateTime":{"type":"string","format":"date-time","description":"Last update timestamp of the instrument.","uniqueKey":"instruments.items.[INDEX].updateTime","typeLabel":"string\u003cdate-time>"}},"description":"Instrument represents a tradable instrument.","uniqueKey":"instruments.items.[INDEX]","typeLabel":"object"},"description":"List of matching instruments","uniqueKey":"instruments","typeLabel":"object[]"},"nextPageToken":{"type":"string","description":"Token for fetching next page (empty if no more results)","uniqueKey":"nextPageToken","typeLabel":"string"},"eof":{"type":"boolean","description":"True when no more results available","uniqueKey":"eof","typeLabel":"boolean"}},"description":"Response with list of instruments.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"instruments":[{"symbol":"\u003cstring>","tickSize":123,"baseCurrency":"\u003cstring>","multiplier":123,"minimumTradeQty":"\u003cstring>","startDate":{"year":123,"month":123,"day":123},"expirationDate":{"year":123,"month":123,"day":123},"terminationDate":{"year":123,"month":123,"day":123},"tradingSchedule":[{"daysOfWeek":[123],"timeOfDay":{"hours":123,"minutes":123,"seconds":123},"duration":"\u003cstring>","state":"INSTRUMENT_STATE_OPEN","hideMarketData":true,"expireAllOrders":true}],"description":"\u003cstring>","clearingHouse":"\u003cstring>","minimumUnaffiliatedFirms":"\u003cstring>","nonTradable":true,"jsonAttributes":"\u003cstring>","productId":"\u003cstring>","priceLimit":{"low":"\u003cstring>","high":"\u003cstring>","lowSet":true,"highSet":true,"relativeLow":123,"relativeHigh":123,"relativeLowSet":true,"relativeHighSet":true},"orderSizeLimit":{"low":"\u003cstring>","high":"\u003cstring>","lowSet":true,"highSet":true,"totalNotionalLow":"\u003cstring>","totalNotionalHigh":"\u003cstring>","totalNotionalLowSet":true,"totalNotionalHighSet":true},"expirationTime":{"hours":123,"minutes":123,"seconds":123},"tradeSettlementPeriod":"\u003cstring>","state":"INSTRUMENT_STATE_OPEN","priceScale":"\u003cstring>","fractionalQtyScale":"\u003cstring>","settlementCurrency":"\u003cstring>","settlementPriceScale":"\u003cstring>","metadata":{},"eventAttributes":{"question":"\u003cstring>","payoutValue":"\u003cstring>","evaluationType":"\u003cstring>","eventId":"\u003cstring>","eventDisplayName":"\u003cstring>","strikeValue":"\u003cstring>","strikeUnit":"\u003cstring>","calculationMethod":"\u003cstring>","positionAccountabilityValue":"\u003cstring>","timeSpecifier":{"year":123,"month":123,"day":123},"eventOutcome":"\u003cstring>"},"createTime":"2023-11-07T05:31:56Z","updateTime":"2023-11-07T05:31:56Z"}],"nextPageToken":"\u003cstring>","eof":true}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f4ed3174-b7b7-4db2-bc52-9370341828fe":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"822f3171-258b-4925-b140-f6222ccc5095":{"url":"https://api.prod.polymarketexchange.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"institutional/oapi-schemas/refdata-schema.json"},"subdomain":"polymarketusdocs","siteName":"Polymarket US Documentation","title":"List instruments - Polymarket US Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-23T16:34:54.100Z","originalFileLocation":"api-reference/referencedata/list-instruments.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=\"Returns a list of instruments matching the request\">\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=\"List instruments - Polymarket US Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a list of instruments matching the request\">\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/referencedata/list-instruments\">\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=ReferenceData\u0026amp;title=List+instruments\u0026amp;description=Returns+a+list+of+instruments+matching+the+request\u0026amp;theme=258f311544a75bb798e8b1d2\u0026amp;signature=ff0a151decd8508ae61d78fee9b7537b2332eec5b5019dcd07d1c42d3aad7cff\">\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=\"List instruments - Polymarket US Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a list of instruments matching the request\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://polymarketusdocs.mintlify.app/_mintlify/api/og/v2?division=ReferenceData\u0026amp;title=List+instruments\u0026amp;description=Returns+a+list+of+instruments+matching+the+request\u0026amp;theme=258f311544a75bb798e8b1d2\u0026amp;signature=ff0a151decd8508ae61d78fee9b7537b2332eec5b5019dcd07d1c42d3aad7cff\">\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/referencedata/list-instruments\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/referencedata/list-instruments.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/referencedata/list-instruments#webpage\",\"url\":\"https://docs.polymarket.us/api-reference/referencedata/list-instruments\",\"name\":\"List instruments\",\"description\":\"Returns a list of instruments matching the request\",\"dateModified\":\"2026-09-23T16:34:54.100Z\",\"isPartOf\":{\"@id\":\"https://docs.polymarket.us#website\"},\"breadcrumb\":{\"@id\":\"https://docs.polymarket.us/api-reference/referencedata/list-instruments#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.polymarket.us/api-reference/referencedata/list-instruments#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference Data\",\"item\":\"https://docs.polymarket.us/institutional/refdata/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List instruments\",\"item\":\"https://docs.polymarket.us/api-reference/referencedata/list-instruments\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.polymarket.us/api-reference/referencedata/list-instruments#apireference\",\"headline\":\"List instruments\",\"name\":\"List instruments\",\"description\":\"Returns a list of instruments matching the request\",\"url\":\"https://docs.polymarket.us/api-reference/referencedata/list-instruments\",\"mainEntityOfPage\":{\"@id\":\"https://docs.polymarket.us/api-reference/referencedata/list-instruments#webpage\"},\"dateModified\":\"2026-09-23T16:34:54.100Z\",\"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","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"WebSockets","pages":[{"title":"WebSockets","href":"/api-reference/websocket/overview"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/api-reference/sdks/introduction"}]},{"tab":"Institutional API","anchors":[{"anchor":"Guide","pages":[{"title":"Guide","href":"/trader-guide/overview"}]},{"anchor":"REST API","groups":[{"group":"Overview","pages":[{"title":"REST API Overview","href":"/institutional/introduction"}]},{"group":"Health","pages":[{"title":"Health API Overview","href":"/institutional/health/overview"},{"group":"Health","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/health-schema.json get /v1/health","href":"/api-reference/health/health-check"}]}]},{"group":"Trading","pages":[{"title":"Trading API Overview","href":"/institutional/trading/overview"},{"group":"Trading","pages":[{"title":"Insert order","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/trading-schema.json post /v1/trading/orders","href":"/api-reference/trading/insert-order"},{"title":"Cancel order","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/trading-schema.json post /v1/trading/orders/cancel","href":"/api-reference/trading/cancel-order"},{"title":"Cancel order list","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/trading-schema.json post /v1/trading/orders/cancel/list","href":"/api-reference/trading/cancel-order-list"},{"title":"Insert order cross","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/trading-schema.json post /v1/trading/orders/cross","href":"/api-reference/trading/insert-order-cross"},{"title":"Insert order list","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/trading-schema.json post /v1/trading/orders/list","href":"/api-reference/trading/insert-order-list"},{"title":"Get open orders","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/trading-schema.json get /v1/trading/orders/open","href":"/api-reference/trading/get-open-orders"},{"title":"Preview order","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/trading-schema.json post /v1/trading/orders/preview","href":"/api-reference/trading/preview-order"},{"title":"Cancel replace order","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/trading-schema.json post /v1/trading/orders/replace","href":"/api-reference/trading/cancel-replace-order"},{"title":"Cancel replace order list","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/trading-schema.json post /v1/trading/orders/replace/list","href":"/api-reference/trading/cancel-replace-order-list"}]}]},{"group":"Combos","pages":[{"title":"Combos API Overview","href":"/institutional/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":"/institutional/rfqs/overview"},{"group":"RFQs","pages":[{"title":"Get RFQs","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json get /v1/rfqs","href":"/institutional/rfqs/get-rfqs"},{"title":"Create RFQ","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json post /v1/rfqs","href":"/institutional/rfqs/create-rfq"},{"title":"Get quotes","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json get /v1/rfqs/quotes","href":"/institutional/rfqs/get-quotes"},{"title":"Create quote","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json post /v1/rfqs/quotes","href":"/institutional/rfqs/create-quote"},{"title":"Get RFQ trades","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json get /v1/rfqs/trades","href":"/institutional/rfqs/get-rfq-trades"},{"title":"Get RFQ user ID","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json get /v1/rfqs/user-id","href":"/institutional/rfqs/get-rfq-user-id"},{"title":"Delete RFQ","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json delete /v1/rfqs/{rfqId}","href":"/institutional/rfqs/delete-rfq"},{"title":"Delete quote","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json delete /v1/rfqs/{rfqId}/quotes/{quoteId}","href":"/institutional/rfqs/delete-quote"},{"title":"Accept quote","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json put /v1/rfqs/{rfqId}/quotes/{quoteId}/accept","href":"/institutional/rfqs/accept-quote"},{"title":"Confirm quote","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/rfqs-schema.json put /v1/rfqs/{rfqId}/quotes/{quoteId}/confirm","href":"/institutional/rfqs/confirm-quote"}]}]},{"group":"Report","pages":[{"title":"Report API Overview","href":"/institutional/report/overview"},{"group":"Report","pages":[{"title":"Download executions CSV","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/report-schema.json post /v1/report/executions/csv","href":"/api-reference/report/download-executions-csv"},{"title":"Search executions","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/report-schema.json post /v1/report/executions/search","href":"/api-reference/report/search-executions"},{"title":"Download orders CSV","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/report-schema.json post /v1/report/orders/csv","href":"/api-reference/report/download-orders-csv"},{"title":"Search orders","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/report-schema.json post /v1/report/orders/search","href":"/api-reference/report/search-orders"},{"title":"Download trades CSV","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/report-schema.json post /v1/report/trades/csv","href":"/api-reference/report/download-trades-csv"},{"title":"Search trades","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/report-schema.json post /v1/report/trades/search","href":"/api-reference/report/search-trades"},{"title":"Get trade stats","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/report-schema.json post /v1/report/trades/stats","href":"/api-reference/report/get-trade-stats"}]}]},{"group":"Positions","pages":[{"title":"Positions API Overview","href":"/institutional/positions/overview"},{"group":"Positions","pages":[{"title":"List account positions","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/positions-schema.json get /v1/positions","href":"/api-reference/positions/list-account-positions"},{"title":"Get account balance","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/positions-schema.json post /v1/positions/balance","href":"/api-reference/positions/get-account-balance"},{"title":"List account balances","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/positions-schema.json post /v1/positions/balances","href":"/api-reference/positions/list-account-balances"},{"title":"Get position ledger","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/positions-schema.json get /v1/positions/ledger","href":"/api-reference/positions/get-position-ledger"},{"title":"Download position ledger as CSV","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/positions-schema.json get /v1/positions/ledger/download","href":"/api-reference/positions/download-position-ledger-as-csv"}]}]},{"group":"Funding","pages":[{"title":"Funding Overview","href":"/institutional/funding/overview"},{"group":"Funding","pages":[{"title":"Get account balance ledger","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/funding-schema.json get /v1/funding/balance-ledger","href":"/api-reference/funding/get-account-balance-ledger"},{"title":"Download account balance ledger as CSV","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/funding-schema.json get /v1/funding/balance-ledger/download","href":"/api-reference/funding/download-account-balance-ledger-as-csv"}]}]},{"group":"Order Book","pages":[{"title":"Order Book API Overview","href":"/institutional/orderbook/overview"},{"group":"Order Book","pages":[{"title":"Get order book","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/orderbook-schema.json get /v1/orderbook/{symbol}","href":"/api-reference/order-book/get-order-book"},{"title":"Get best bid/offer","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/orderbook-schema.json get /v1/orderbook/{symbol}/bbo","href":"/api-reference/order-book/get-best-bidoffer"}]}]},{"group":"Settlement","pages":[{"title":"Settlement API Overview","href":"/institutional/settlement/overview"},{"group":"Settlement","pages":[{"title":"Get instrument settlement","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/settlement-schema.json get /v1/instruments/{symbol}/settlement","href":"/api-reference/settlement/get-instrument-settlement"}]}]},{"group":"Reference Data","pages":[{"title":"Reference Data API Overview","description":"Instruments, symbols, and market metadata","href":"/institutional/refdata/overview"},{"group":"ReferenceData","pages":[{"title":"List instruments","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/refdata-schema.json post /v1/refdata/instruments","href":"/api-reference/referencedata/list-instruments"},{"title":"Get instrument metadata","description":"Returns miscellaneous instrument metadata","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/refdata-schema.json post /v1/refdata/metadata","href":"/api-reference/referencedata/get-instrument-metadata"},{"title":"List symbols","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/refdata-schema.json post /v1/refdata/symbols","href":"/api-reference/referencedata/list-symbols"}]}]},{"group":"Accounts","pages":[{"title":"Accounts API Overview","href":"/institutional/accounts/overview"},{"group":"Accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/accounts-schema.json get /v1/accounts","href":"/api-reference/accounts/list-accounts"},{"title":"List users","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/accounts-schema.json get /v1/users","href":"/api-reference/accounts/list-users"},{"title":"Get who am I","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/accounts-schema.json get /v1/whoami","href":"/api-reference/accounts/get-who-am-i"}]}]},{"group":"Payments","pages":[{"title":"Payments Overview","href":"/institutional/payments/overview"},{"title":"Aeropay Integration","href":"/institutional/payments/aeropay-guide"},{"title":"Checkout Integration","href":"/institutional/payments/checkout-guide"},{"title":"Funding Management","href":"/institutional/payments/funding-management"}]},{"group":"Incentives","pages":[{"title":"Incentives API Overview","href":"/institutional/incentives/overview"},{"group":"Incentives","pages":[{"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 Incentive Earnings","deprecated":null,"version":null,"openapi":"/institutional/oapi-schemas/incentives-schema.json get /v1/incentives/earnings","href":"/api-reference/incentives/get-incentive-earnings"}]}]}]},{"anchor":"gRPC API","pages":[{"title":"gRPC API","href":"/grpc-api/overview"}]},{"anchor":"FIX API","pages":[{"title":"FIX API","href":"/institutional/fix-api/fix-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":"List instruments - Polymarket US Documentation","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}