{
"code": "unsupported_game",
"detail": "appId 440 is not available to this key. Supported: 730 (CS2), 570 (Dota 2), 252490 (Rust).",
"supported_app_ids": [
730,
570,
252490
]
}
{
"code": "missing_api_key",
"detail": "Provide your API key via `Authorization: Bearer csb_pub_…`. Generate one at https://csboard.com/profile?tab=api"
}
{
"code": "invalid_request",
"detail": "Provide between 1 and 100 ids in the ids parameter."
}
{
"code": "rate_limit_exceeded",
"detail": "Read rate limit of 100 requests/min exceeded. The counter restarts in 23 s. For new listings use GET /v1/listings/stream instead of polling.",
"bucket": "read",
"limit_per_min": 100,
"retry_after_sec": 23
}
Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-RateLimit-Bucket for the bucket the call spent. See Rate limits.
Steam appId of the game. 730 = CS2 (the default), 570 = Dota 2, 252490 = Rust. Omit it and the endpoint answers for CS2 exactly as before. An appId this key may not use answers 400 unsupported_game, whose supported_app_ids lists the ones it may — see GET /games.
{
"code": "unsupported_game",
"detail": "appId 440 is not available to this key. Supported: 730 (CS2), 570 (Dota 2), 252490 (Rust).",
"supported_app_ids": [
730,
570,
252490
]
}
{
"code": "missing_api_key",
"detail": "Provide your API key via `Authorization: Bearer csb_pub_…`. Generate one at https://csboard.com/profile?tab=api"
}
{
"code": "invalid_request",
"detail": "Provide between 1 and 100 ids in the ids parameter."
}
{
"code": "rate_limit_exceeded",
"detail": "Read rate limit of 100 requests/min exceeded. The counter restarts in 23 s. For new listings use GET /v1/listings/stream instead of polling.",
"bucket": "read",
"limit_per_min": 100,
"retry_after_sec": 23
}
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"CSBoard API","colors":{"primary":"#2563eb","light":"#60a5fa","dark":"#172554"},"favicon":"https://mintcdn.com/csboard/LyXJsSfteiiBK7GJ/favicon.svg?fit=max\u0026auto=format\u0026n=LyXJsSfteiiBK7GJ\u0026q=85\u0026s=29fd93b872ec9ce02b5ca0a5aecc8d03","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://csboard.com/profile?tab=api","label":"Get a key"}],"primary":{"type":"button","label":"csboard.com","href":"https://csboard.com"}},"footer":{"socials":{"website":"https://csboard.com"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","href":"introduction"},{"language":"ru","href":"ru/introduction"},{"language":"zh-Hans","href":"zh-Hans/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"csboard","hasAudioNarration":false,"actualSubdomain":"csboard","customDomains":["api.csboard.com"],"gitSource":{"type":"github","owner":"kizilovv","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aed460334fe7746877e0ec2","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"en","tag":"API Reference","count":42},{"language":"ru","tag":"Справочник API","count":22},{"language":"zh-Hans","tag":"API 参考","count":22},{"language":"en","tag":"Market Data","count":10},{"language":"en","tag":"Guides","count":10},{"language":"en","tag":"Webhooks","count":8},{"language":"ru","tag":"Рыночные данные","count":8},{"language":"ru","tag":"Руководства","count":8},{"language":"zh-Hans","tag":"市场数据","count":8},{"language":"zh-Hans","tag":"指南","count":8},{"language":"en","tag":"Trading","count":7},{"language":"ru","tag":"Торговля","count":7},{"language":"zh-Hans","tag":"交易","count":7},{"language":"en","tag":"Instant Sell","count":6},{"language":"en","tag":"Walkthroughs","count":6},{"language":"en","tag":"P2P","count":5},{"language":"en","tag":"Account","count":5},{"language":"ru","tag":"P2P","count":5},{"language":"ru","tag":"Инструкции","count":5},{"language":"zh-Hans","tag":"P2P","count":5},{"language":"zh-Hans","tag":"教程","count":5},{"language":"en","tag":"Get Started","count":4},{"language":"ru","tag":"Начало работы","count":3},{"language":"zh-Hans","tag":"快速开始","count":3},{"language":"ru","tag":"Аккаунт","count":1},{"language":"ru","tag":"Статус","count":1},{"language":"ru","tag":"Журнал изменений","count":1},{"language":"zh-Hans","tag":"账户","count":1},{"language":"zh-Hans","tag":"状态","count":1},{"language":"zh-Hans","tag":"更新日志","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"zh-Hans/api-reference/get-listings-availability","slug":"/zh-Hans/api-reference/get-listings-availability","pageMetadata":{"title":"GET /v1/listings/availability — 批量可用性查询","sidebarTitle":"GET /listings/availability","description":"在单次请求中检查最多 100 个 CSBoard 商品是否仍可购买,返回每个可用 id 的实时价格以及不可用 id 列表。","openapi":"GET /listings/availability","href":"/zh-Hans/api-reference/get-listings-availability"},"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: \"在单次请求中检查最多 100 个 CSBoard 商品是否仍可购买,返回每个可用 id 的实时价格以及不可用 id 列表。\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,ResponseField,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`在下批量订单之前,请确认您打算购买的商品仍然可用。通过逗号分隔的 `,_jsx(_components.code,{children:`ids`}),` 参数最多传入 100 个商品 id;响应会给出每个仍可用 id 的实时价格,并列出已不再可用的 id。`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`需要身份验证。`}),` 请将密钥作为 `,_jsx(_components.code,{children:`Authorization: Bearer csb_pub_...`}),` 发送。`]}),`\n`,_jsx(Heading,{level:`2`,id:`查询参数`,children:`查询参数`}),`\n`,_jsx(ParamField,{query:`ids`,type:`string`,required:true,id:`param-ids`,children:_jsxs(_components.p,{children:[`以逗号分隔的商品 id,例如 `,_jsx(_components.code,{children:`itm_8841201,itm_8841340`}),`。`,_jsx(_components.strong,{children:`必填。`}),` 每次请求最多 100 个 id。`]})}),`\n`,_jsx(ParamField,{query:`appId`,default:`730`,type:`integer`,id:`param-app-id`,children:_jsxs(_components.p,{children:[`这些 id 所属的游戏:`,_jsx(_components.code,{children:`730`}),` = CS2,`,_jsx(_components.code,{children:`570`}),` = Dota 2,`,_jsx(_components.code,{children:`252490`}),` = Rust。请使用您从 `,_jsx(_components.code,{children:`GET /v1/listings`}),` 读取这些 id 时所用的同一个 `,_jsx(_components.code,{children:`appId`}),`。`]})}),`\n`,_jsx(Heading,{level:`2`,id:`响应字段`,children:`响应字段`}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,required:true,id:`param-data`,children:_jsxs(Expandable,{title:`data object`,children:[_jsx(ResponseField,{name:`available`,type:`object`,required:true,id:`param-available`,children:_jsx(_components.p,{children:`商品 id → 其当前美元价格的映射。所有仍可用的 id 都会出现在这里。`})}),_jsx(ResponseField,{name:`unavailable_ids`,type:`string[]`,required:true,id:`param-unavailable-ids`,children:_jsx(_components.p,{children:`已不再可用的商品 id。`})})]})}),`\n`,_jsx(Heading,{level:`2`,id:`示例请求`,children:`示例请求`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://csboard.com/v1/listings/availability?ids=itm_8841201,itm_8841340,itm_8841999\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer csb_pub_...\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`示例响应`,children:`示例响应`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"available\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"itm_8841201\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`14.37`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"itm_8841340\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12.1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"unavailable_ids\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"itm_8841999\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`错误代码`,children:`错误代码`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP 状态码`}),_jsx(_components.th,{children:`代码`}),_jsx(_components.th,{children:`含义`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`unsupported_game`})}),_jsxs(_components.td,{children:[`您的密钥无法使用该 `,_jsx(_components.code,{children:`appId`}),`。`,_jsx(_components.code,{children:`supported_app_ids`}),` 列出了可用的值。`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`missing_api_key`}),` / `,_jsx(_components.code,{children:`invalid_api_key`})]}),_jsx(_components.td,{children:`API 密钥缺失或无效。`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`422`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_request`})}),_jsxs(_components.td,{children:[`未提供 `,_jsx(_components.code,{children:`ids`}),`,或提供了超过 100 个 id。`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`rate_limit_exceeded`})}),_jsxs(_components.td,{children:[`请求过多。请按照 `,_jsx(_components.code,{children:`Retry-After`}),` 响应头中的秒数退避。`]})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`可用性是一个时间点快照。报告为可用的 id 仍可能在您的购买执行前售罄——请始终发送 `,_jsx(_components.code,{children:`max_price_usd`}),`,并在购买调用中处理 `,_jsx(_components.code,{children:`item_unavailable`}),`。`]})})]})}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":"GET /v1/listings/availability — 批量可用性查询","sidebarTitle":"GET /listings/availability","description":"在单次请求中检查最多 100 个 CSBoard 商品是否仍可购买,返回每个可用 id 的实时价格以及不可用 id 列表。","openapi":"GET /listings/availability","href":"/zh-Hans/api-reference/get-listings-availability"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"查询参数","slug":"查询参数","depth":2,"children":[]},{"title":"响应字段","slug":"响应字段","depth":2,"children":[]},{"title":"示例请求","slug":"示例请求","depth":2,"children":[]},{"title":"示例响应","slug":"示例响应","depth":2,"children":[]},{"title":"错误代码","slug":"错误代码","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Market data"],"summary":"Bulk availability check","description":"在单次请求中检查最多 100 个 CSBoard 商品是否仍可购买,返回每个可用 id 的实时价格以及不可用 id 列表。","operationId":"getListingsAvailability","parameters":["25b2d107-099c-49da-8920-9e34fe841c83","2f9b3792-9013-4108-a81e-fe459390f12d"],"responses":{"200":"790a8cbe-12a6-4d79-82da-49ff91505d92","400":"61530f3b-e4e1-462c-8309-3dc46057b39b","401":"25fa6484-02a6-4e2c-b6c6-4b671694ed0f","422":"ecf0d2df-5fae-415c-a1cc-a416ece8da2f","429":"39cde1ff-8b51-456f-aec4-5981b0612c4d"},"method":"get","type":"path","servers":["0e703a7c-bb72-4382-a5c4-7af713801e30"],"security":["06dc2d5d-3307-4e9d-932f-2c2f29b1a6df"],"path":"/listings/availability","baseUrlOptions":["https://csboard.com/v1"],"title":"Bulk availability check","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"25b2d107-099c-49da-8920-9e34fe841c83":{"name":"ids","in":"query","required":true,"description":"Comma-separated listing ids. Required. Maximum 100 ids per request.","schema":{"type":"string","isRequired":true,"description":"Comma-separated listing ids. Required. Maximum 100 ids per request.","uniqueKey":"","typeLabel":"string"}},"2f9b3792-9013-4108-a81e-fe459390f12d":{"name":"appId","in":"query","required":false,"description":"Steam appId of the game. `730` = CS2 (the default), `570` = Dota 2, `252490` = Rust. Omit it and the endpoint answers for CS2 exactly as before. An appId this key may not use answers `400 unsupported_game`, whose `supported_app_ids` lists the ones it may — see `GET /games`.","schema":{"type":"integer","enum":[730,570,252490],"default":730,"isRequired":false,"description":"Steam appId of the game. `730` = CS2 (the default), `570` = Dota 2, `252490` = Rust. Omit it and the endpoint answers for CS2 exactly as before. An appId this key may not use answers `400 unsupported_game`, whose `supported_app_ids` lists the ones it may — see `GET /games`.","uniqueKey":"","typeLabel":"enum\u003cinteger>"}}},"responses":{"790a8cbe-12a6-4d79-82da-49ff91505d92":{"description":"Availability map for the requested ids.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"available":{"type":"object","additionalProperties":{"type":"number","uniqueKey":"data.available.additionalProperties","typeLabel":"number"},"description":"Map of listing id → its current price in USD, for every id that is still available.","isRequired":true,"uniqueKey":"data.available","typeLabel":"object"},"unavailable_ids":{"type":"array","items":{"type":"string","uniqueKey":"data.unavailable_ids.items.[INDEX]","typeLabel":"string"},"description":"Ids that are no longer available.","isRequired":true,"uniqueKey":"data.unavailable_ids","typeLabel":"string[]"}},"required":["available","unavailable_ids"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"example":{"data":{"available":{"itm_8841201":14.37,"itm_8841340":12.1},"unavailable_ids":["itm_8841999"]}},"examples":{"Example":{"title":"Example","value":{"data":{"available":{"itm_8841201":14.37,"itm_8841340":12.1},"unavailable_ids":["itm_8841999"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"61530f3b-e4e1-462c-8309-3dc46057b39b":{"description":"An `appId` this key may not use (`unsupported_game`).","content":{"application/json":{"schema":{"type":"object","description":"All errors return { code, detail }. Some carry extra fields (e.g. price_moved adds current_total_usd, insufficient_balance adds required_usd/current_usd, item_unavailable adds unavailable_ids and, on CS2 buys, unknown_ids).","properties":{"code":{"type":"string","description":"Machine-readable error code, e.g. rate_limit_exceeded, trading_not_enabled, price_moved.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable explanation.","uniqueKey":"detail","typeLabel":"string"}},"required":["code"],"uniqueKey":"","typeLabel":"object"},"examples":{"unsupported_game":{"title":"unsupported_game","value":{"code":"unsupported_game","detail":"appId 440 is not available to this key. Supported: 730 (CS2), 570 (Dota 2), 252490 (Rust).","supported_app_ids":[730,570,252490]}}},"exampleType":"examples"}},"exampleType":"examples"},"25fa6484-02a6-4e2c-b6c6-4b671694ed0f":{"description":"Missing or invalid API key (`missing_api_key` or `invalid_api_key`).","content":{"application/json":{"schema":{"type":"object","description":"All errors return { code, detail }. Some carry extra fields (e.g. price_moved adds current_total_usd, insufficient_balance adds required_usd/current_usd, item_unavailable adds unavailable_ids and, on CS2 buys, unknown_ids).","properties":{"code":{"type":"string","description":"Machine-readable error code, e.g. rate_limit_exceeded, trading_not_enabled, price_moved.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable explanation.","uniqueKey":"detail","typeLabel":"string"}},"required":["code"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"missing_api_key","detail":"Provide your API key via `Authorization: Bearer csb_pub_…`. Generate one at https://csboard.com/profile?tab=api"},"examples":{"Example":{"title":"Example","value":{"code":"missing_api_key","detail":"Provide your API key via `Authorization: Bearer csb_pub_…`. Generate one at https://csboard.com/profile?tab=api"}}},"exampleType":"examples"}},"exampleType":"examples"},"ecf0d2df-5fae-415c-a1cc-a416ece8da2f":{"description":"Invalid request — `ids` missing or more than 100 ids supplied.","content":{"application/json":{"schema":{"type":"object","description":"All errors return { code, detail }. Some carry extra fields (e.g. price_moved adds current_total_usd, insufficient_balance adds required_usd/current_usd, item_unavailable adds unavailable_ids and, on CS2 buys, unknown_ids).","properties":{"code":{"type":"string","description":"Machine-readable error code, e.g. rate_limit_exceeded, trading_not_enabled, price_moved.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable explanation.","uniqueKey":"detail","typeLabel":"string"}},"required":["code"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"invalid_request","detail":"Provide between 1 and 100 ids in the ids parameter."},"examples":{"Example":{"title":"Example","value":{"code":"invalid_request","detail":"Provide between 1 and 100 ids in the ids parameter."}}},"exampleType":"examples"}},"exampleType":"examples"},"39cde1ff-8b51-456f-aec4-5981b0612c4d":{"description":"A per-key limit is spent. The key's own buckets answer `rate_limit_exceeded` with `bucket` (`read`, `trading` or `buy_orders`), `limit_per_min` and `retry_after_sec`. `Retry-After` is the seconds left until the one-minute window restarts (1–60), not a flat 60. Endpoint-specific limits (`snapshot_rate_limited` on the price snapshot, `rate_limited` on Instant Sell) send only `code` and `detail`.","headers":{"Retry-After":{"description":"Seconds until the one-minute window restarts (1–60). Waiting that long is always enough.","schema":{"type":"integer"}},"X-RateLimit-Limit":{"description":"The ceiling per minute of the bucket this call spent (named in `X-RateLimit-Bucket`).","schema":{"type":"integer"},"example":3000},"X-RateLimit-Remaining":{"description":"Calls left on that bucket in the current one-minute window.","schema":{"type":"integer","minimum":0},"example":2987},"X-RateLimit-Reset":{"description":"Seconds until the one-minute window restarts and the counter starts again.","schema":{"type":"integer","minimum":1,"maximum":60},"example":41},"X-RateLimit-Bucket":{"description":"The bucket this call spent: `read` (reads and every other keyed call) or `trading` (buys, order reads, claims, cancels, balance). A `429` from the buy-order limit says `buy_orders`.","schema":{"type":"string","enum":["read","trading","buy_orders"]},"example":"trading"}},"content":{"application/json":{"schema":{"type":"object","description":"The `429` body of a per-key bucket. Endpoint-specific limits send only `code` and `detail`.","properties":{"code":{"type":"string","description":"`rate_limit_exceeded` for the key's buckets. Endpoint-specific limits use their own code (`snapshot_rate_limited`, `rate_limited`).","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","description":"Human-readable explanation.","uniqueKey":"detail","typeLabel":"string"},"bucket":{"type":"string","enum":["read","trading","buy_orders"],"description":"Which bucket is spent.","uniqueKey":"bucket","typeLabel":"enum\u003cstring>"},"limit_per_min":{"type":"integer","description":"That bucket's ceiling per minute.","uniqueKey":"limit_per_min","typeLabel":"integer"},"retry_after_sec":{"type":"integer","minimum":1,"maximum":60,"description":"Seconds until the window restarts — the same number as `Retry-After`.","uniqueKey":"retry_after_sec","typeLabel":"integer"}},"required":["code"],"uniqueKey":"","typeLabel":"object"},"example":{"code":"rate_limit_exceeded","detail":"Read rate limit of 100 requests/min exceeded. The counter restarts in 23 s. For new listings use GET /v1/listings/stream instead of polling.","bucket":"read","limit_per_min":100,"retry_after_sec":23},"examples":{"Example":{"title":"Example","value":{"code":"rate_limit_exceeded","detail":"Read rate limit of 100 requests/min exceeded. The counter restarts in 23 s. For new listings use GET /v1/listings/stream instead of polling.","bucket":"read","limit_per_min":100,"retry_after_sec":23}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"06dc2d5d-3307-4e9d-932f-2c2f29b1a6df":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Send your key as a Bearer token on every request: `Authorization: Bearer csb_pub_...`. Generate keys in your CSBoard profile. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` and `X-RateLimit-Bucket` for the bucket the call spent. See [Rate limits](/rate-limits).","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0e703a7c-bb72-4382-a5c4-7af713801e30":{"url":"https://csboard.com/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Send your key as a Bearer token on every request: `Authorization: Bearer csb_pub_...`. Generate keys in your CSBoard profile. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` and `X-RateLimit-Bucket` for the bucket the call spent. See [Rate limits](/rate-limits).","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send your key as a Bearer token on every request: `Authorization: Bearer csb_pub_...`. Generate keys in your CSBoard profile. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` and `X-RateLimit-Bucket` for the bucket the call spent. See [Rate limits](/rate-limits).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"csboard","siteName":"CSBoard API","title":"GET /v1/listings/availability — 批量可用性查询 - CSBoard API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/get-listings-availability","matchLevel":1},"ru":{"href":"/ru/api-reference/get-listings-availability","matchLevel":1},"zh-Hans":{"href":"/zh-Hans/api-reference/get-listings-availability","matchLevel":0}}},"lastModified":"2026-10-02T12:04:28.028Z","originalFileLocation":"zh-Hans/api-reference/get-listings-availability.mdx","locale":"zh-Hans"},"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=\"dark\"}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=\"在单次请求中检查最多 100 个 CSBoard 商品是否仍可购买,返回每个可用 id 的实时价格以及不可用 id 列表。\">\u003cmeta data-mint-head name=\"application-name\" content=\"CSBoard API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/csboard/m4zEijRxsV60XgHV/_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/csboard/m4zEijRxsV60XgHV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/csboard/m4zEijRxsV60XgHV/_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/csboard/m4zEijRxsV60XgHV/_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/csboard/m4zEijRxsV60XgHV/_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/csboard/m4zEijRxsV60XgHV/_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/csboard/m4zEijRxsV60XgHV/_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/csboard/m4zEijRxsV60XgHV/_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/csboard/m4zEijRxsV60XgHV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"GET /v1/listings/availability — 批量可用性查询 - CSBoard API\">\u003cmeta data-mint-head property=\"og:description\" content=\"在单次请求中检查最多 100 个 CSBoard 商品是否仍可购买,返回每个可用 id 的实时价格以及不可用 id 列表。\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CSBoard API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://csboard.mintlify.site/_mintlify/api/og/v2?division=%E5%B8%82%E5%9C%BA%E6%95%B0%E6%8D%AE\u0026amp;title=GET+%2Fv1%2Flistings%2Favailability+%E2%80%94+%E6%89%B9%E9%87%8F%E5%8F%AF%E7%94%A8%E6%80%A7%E6%9F%A5%E8%AF%A2\u0026amp;description=%E5%9C%A8%E5%8D%95%E6%AC%A1%E8%AF%B7%E6%B1%82%E4%B8%AD%E6%A3%80%E6%9F%A5%E6%9C%80%E5%A4%9A+100+%E4%B8%AA+CSBoard+%E5%95%86%E5%93%81%E6%98%AF%E5%90%A6%E4%BB%8D%E5%8F%AF%E8%B4%AD%E4%B9%B0%EF%BC%8C%E8%BF%94%E5%9B%9E%E6%AF%8F%E4%B8%AA%E5%8F%AF%E7%94%A8+id+%E7%9A%84%E5%AE%9E%E6%97%B6%E4%BB%B7%E6%A0%BC%E4%BB%A5%E5%8F%8A%E4%B8%8D%E5%8F%AF%E7%94%A8+id+%E5%88%97%E8%A1%A8%E3%80%82\u0026amp;theme=932e691933583ab42431355a\u0026amp;signature=bc5b539dec2b0984219f6092e081b2e1543c3681cec0617ed52d33e4799231c0\">\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=\"GET /v1/listings/availability — 批量可用性查询 - CSBoard API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"在单次请求中检查最多 100 个 CSBoard 商品是否仍可购买,返回每个可用 id 的实时价格以及不可用 id 列表。\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://csboard.mintlify.site/_mintlify/api/og/v2?division=%E5%B8%82%E5%9C%BA%E6%95%B0%E6%8D%AE\u0026amp;title=GET+%2Fv1%2Flistings%2Favailability+%E2%80%94+%E6%89%B9%E9%87%8F%E5%8F%AF%E7%94%A8%E6%80%A7%E6%9F%A5%E8%AF%A2\u0026amp;description=%E5%9C%A8%E5%8D%95%E6%AC%A1%E8%AF%B7%E6%B1%82%E4%B8%AD%E6%A3%80%E6%9F%A5%E6%9C%80%E5%A4%9A+100+%E4%B8%AA+CSBoard+%E5%95%86%E5%93%81%E6%98%AF%E5%90%A6%E4%BB%8D%E5%8F%AF%E8%B4%AD%E4%B9%B0%EF%BC%8C%E8%BF%94%E5%9B%9E%E6%AF%8F%E4%B8%AA%E5%8F%AF%E7%94%A8+id+%E7%9A%84%E5%AE%9E%E6%97%B6%E4%BB%B7%E6%A0%BC%E4%BB%A5%E5%8F%8A%E4%B8%8D%E5%8F%AF%E7%94%A8+id+%E5%88%97%E8%A1%A8%E3%80%82\u0026amp;theme=932e691933583ab42431355a\u0026amp;signature=bc5b539dec2b0984219f6092e081b2e1543c3681cec0617ed52d33e4799231c0\">\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/csboard/m4zEijRxsV60XgHV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CSBoard API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/zh-Hans/api-reference/get-listings-availability.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hans\" href=\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://api.csboard.com/api-reference/get-listings-availability\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://api.csboard.com/ru/api-reference/get-listings-availability\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://api.csboard.com/api-reference/get-listings-availability\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api.csboard.com/#organization\",\"name\":\"CSBoard API\",\"url\":\"https://api.csboard.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://api.csboard.com#website\",\"name\":\"CSBoard API\",\"url\":\"https://api.csboard.com\",\"publisher\":{\"@id\":\"https://api.csboard.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability#webpage\",\"url\":\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability\",\"name\":\"GET /v1/listings/availability — 批量可用性查询\",\"description\":\"在单次请求中检查最多 100 个 CSBoard 商品是否仍可购买,返回每个可用 id 的实时价格以及不可用 id 列表。\",\"dateModified\":\"2026-10-02T12:04:28.028Z\",\"isPartOf\":{\"@id\":\"https://api.csboard.com#website\"},\"breadcrumb\":{\"@id\":\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"市场数据\",\"item\":\"https://api.csboard.com/zh-Hans/api-reference/get-listings\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GET /v1/listings/availability — 批量可用性查询\",\"item\":\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability#apireference\",\"headline\":\"GET /v1/listings/availability — 批量可用性查询\",\"name\":\"GET /v1/listings/availability — 批量可用性查询\",\"description\":\"在单次请求中检查最多 100 个 CSBoard 商品是否仍可购买,返回每个可用 id 的实时价格以及不可用 id 列表。\",\"url\":\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability\",\"mainEntityOfPage\":{\"@id\":\"https://api.csboard.com/zh-Hans/api-reference/get-listings-availability#webpage\"},\"dateModified\":\"2026-10-02T12:04:28.028Z\",\"publisher\":{\"@id\":\"https://api.csboard.com/#organization\"},\"isPartOf\":{\"@id\":\"https://api.csboard.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CSBoard API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CSBoard API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/zh-Hans/api-reference/get-listings-availability.md","siteName":"CSBoard API","nav":{"global":null,"languages":[{"language":"en","pages":[{"title":"en","href":"/api-reference/get-listings-availability"}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/api-reference/get-listings-availability"}]},{"language":"zh-Hans","tabs":[{"tab":"指南","pages":[{"title":"指南","href":"/zh-Hans/introduction"}]},{"tab":"API 参考","groups":[{"group":"市场数据","pages":[{"title":"GET /v1/listings — 浏览实时的 CS2 市场挂单","sidebarTitle":"GET /listings","openapi":"GET /listings","href":"/zh-Hans/api-reference/get-listings"},{"title":"GET /v1/listings/stream — 上架与售出的实时推送","sidebarTitle":"GET /listings/stream","description":"通过 Server-Sent Events 在 CS2 挂单出现和售出的那一刻订阅它们。取代轮询,并告诉您商品何时消失。","openapi":"GET /listings/stream","href":"/zh-Hans/api-reference/get-listings-stream"},{"title":"GET /v1/listings/availability — 批量可用性查询","sidebarTitle":"GET /listings/availability","openapi":"GET /listings/availability","href":"/zh-Hans/api-reference/get-listings-availability"},{"title":"GET /v1/games — 可作为 appId 传入的游戏","sidebarTitle":"GET /games","description":"列出您的密钥可以通过 appId 读取的游戏——CS2、Dota 2 和 Rust——以及在每个游戏中是否也可以购买。","openapi":"GET /games","href":"/zh-Hans/api-reference/get-games"},{"title":"GET /v1/prices — 按商品组的 CS2 minAsk 价格列表","sidebarTitle":"GET /prices","openapi":"GET /prices","href":"/zh-Hans/api-reference/get-prices"},{"title":"GET /v1/prices/snapshot.ndjson.gz — 完整价格快照","sidebarTitle":"GET /prices/snapshot","openapi":"GET /prices/snapshot.ndjson.gz","href":"/zh-Hans/api-reference/get-prices-snapshot"},{"title":"GET /v1/public/prices — 无需密钥的 CS2、Dota 2 与 Rust 最低价数据源","sidebarTitle":"GET /public/prices","openapi":"GET /public/prices","href":"/zh-Hans/api-reference/get-public-prices"},{"title":"GET /v1/currency — 用于美元价格换算的汇率","sidebarTitle":"GET /currency","openapi":"GET /currency","href":"/zh-Hans/api-reference/get-currency"}]},{"group":"交易","pages":[{"title":"POST /v1/orders — 使用余额购买 CS2 挂单","sidebarTitle":"POST /orders","openapi":"POST /orders","href":"/zh-Hans/api-reference/post-orders"},{"title":"POST /v1/market/buy — 购买并交付到 Steam 交易链接","sidebarTitle":"POST /market/buy","openapi":"POST /market/buy","href":"/zh-Hans/api-reference/post-market-buy"},{"title":"POST /v1/orders/:id/claim — 领取处于持有中的订单","sidebarTitle":"POST /orders/:id/claim","openapi":"POST /orders/{id}/claim","href":"/zh-Hans/api-reference/post-orders-claim"},{"title":"POST /v1/orders/:id/cancel — 取消尚未交付的订单","sidebarTitle":"POST /orders/:id/cancel","openapi":"POST /orders/{id}/cancel","href":"/zh-Hans/api-reference/post-orders-cancel"},{"title":"GET /v1/orders — 列出您的购买历史","sidebarTitle":"GET /orders","openapi":"GET /orders","href":"/zh-Hans/api-reference/get-orders"},{"title":"GET /v1/orders/info — 批量订单查询","sidebarTitle":"GET /orders/info","openapi":"GET /orders/info","href":"/zh-Hans/api-reference/get-orders-info"},{"title":"GET /v1/orders/{id} — 获取单个订单","sidebarTitle":"GET /orders/{id}","openapi":"GET /orders/{id}","href":"/zh-Hans/api-reference/get-order"}]},{"group":"P2P","pages":[{"title":"GET /v1/p2p/inventory — 可上架的 CS2 库存","sidebarTitle":"GET /p2p/inventory","openapi":"GET /p2p/inventory","href":"/zh-Hans/api-reference/get-p2p-inventory"},{"title":"POST /v1/p2p/listings — 在 P2P 市场上架您的 CS2 物品","sidebarTitle":"POST /p2p/listings","openapi":"POST /p2p/listings","href":"/zh-Hans/api-reference/post-p2p-listings"},{"title":"GET /v1/p2p/listings — 您的 P2P 挂单","sidebarTitle":"GET /p2p/listings","openapi":"GET /p2p/listings","href":"/zh-Hans/api-reference/get-p2p-listings"},{"title":"PATCH /v1/p2p/listings/{id} — 修改挂单价格","sidebarTitle":"PATCH /p2p/listings/{id}","openapi":"PATCH /p2p/listings/{id}","href":"/zh-Hans/api-reference/patch-p2p-listing"},{"title":"DELETE /v1/p2p/listings/{id} — 下架 P2P 挂单","sidebarTitle":"DELETE /p2p/listings/{id}","openapi":"DELETE /p2p/listings/{id}","href":"/zh-Hans/api-reference/delete-p2p-listing"}]},{"group":"账户","pages":[{"title":"GET /v1/balance — 账户余额与交易状态","sidebarTitle":"GET /balance","openapi":"GET /balance","href":"/zh-Hans/api-reference/get-balance"}]},{"group":"状态","pages":[{"title":"GET /v1/health — CSBoard API 存活与新鲜度探针","sidebarTitle":"GET /health","openapi":"GET /health","href":"/zh-Hans/api-reference/get-health"}]}]},{"tab":"更新日志","pages":[{"title":"更新日志","href":"/zh-Hans/changelog/overview"}]}]}]},"basePath":"","title":"GET /v1/listings/availability — 批量可用性查询 - CSBoard API","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DTNSD-0M.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}