GET /v1/listings/snapshot.ndjson.gz — Every Listing in One File
Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.
GET
/
listings
/
snapshot.ndjson.gz
Every buyable listing in one file (gzipped NDJSON)
{
"code": "missing_api_key",
"detail": "Provide your API key via `Authorization: Bearer csb_pub_…`. Generate one at https://csboard.com/profile?tab=api"
}
Every buyable listing as one gzipped NDJSON file. Each decompressed line is one Listing JSON object — the exact shape GET /v1/listings returns, with the same one-listing-per-physical-skin rule and your negotiated discount already applied.This is the way to hold a complete local copy of the shelf. Walking /v1/listings page by page works for a filtered subset; for everything, it is tens of thousands of reads per pass. Download this file once instead, then open /v1/listings/stream from the position the file hands you, and your copy stays current from there.Authentication required. Send your key as Authorization: Bearer csb_pub_....Limit: six full downloads per hour per key. A 304 answer to a conditional request is free.
The pairing: file + stream
Download the file. Keep the ETag and the X-Stream-Position response headers.
Connect to /v1/listings/stream?last_event_id=<X-Stream-Position>. The stream replays everything that happened since the file was built, then goes live. Apply new and update as an upsert by id (a listing may already be in your copy) and gone as a delete. update carries reprices, so your copy keeps current prices without re-downloading.
Re-download on your own cadence — hourly is plenty — with If-None-Match. A reprice of a listing that was already live is not a stream event; the next file carries it. Between files a stale price is refused at checkout with price_moved, never filled.
If the stream answers resync, your position has aged out of its history: download the file again and reconnect from its new X-Stream-Position.
Request headers
string
The ETag from your previous download. Unchanged → 304 Not Modified, no body, no charge against the hourly limit.
string
The Last-Modified from your previous download. Same effect as If-None-Match.
Response headers
Header
Description
ETag
Opaque version of this file. Send it back as If-None-Match.
Last-Modified
When this file was built (HTTP date).
X-Snapshot-At
The same build time, ISO-8601 with milliseconds.
X-Stream-Position
The stream event id to connect with (last_event_id) so nothing between this file and your live view is missed.
X-Row-Count
Number of listings in the file.
Content-Encoding
gzip — the body is always compressed; Content-Length is the compressed size.
Response body
A gzip stream. Every decompressed line is a Listing:
{"id":"000012e8-1f4a-4c2b-9d3e-7a1b2c3d4e5f","market_hash_name":"AK-47 | Redline (Field-Tested)","wear":"Field-Tested","doppler_phase":null,"float_value":0.2613,"paint_seed":661,"stickers":[{"name":"Sticker | Natus Vincere | Katowice 2015","image":"https://…","slot":2,"wear":0.12}],"price_usd":31.2,"category":"Rifle","rarity":"Classified","image":"https://…","inspect_link":"steam://rungame/730/…","tradable":true,"tradable_at":null,"delivery":"instant","refund_percent":100,"listed_at":"2026-10-20T09:14:02.481Z"}
The file is not filtered: all three delivery buckets (instant, up_to_12h, hold) are in it. Filter on the field locally. It is rebuilt every 10 minutes while anyone is downloading it, CS2 only (appId is not read).
Example: download, then stream from the file’s position
No file exists yet — the first minutes after a deploy. Retry after Retry-After seconds (also in retry_after_seconds).
304
(no body)
Unchanged since the ETag or date you sent.
401
missing_api_key, invalid_api_key
Missing or invalid API key.
429
snapshot_rate_limited
More than six full downloads this hour. Send If-None-Match and take live changes from the stream.
The price list by name — one row per market_hash_name with its cheapest ask — is a different, much smaller file: GET /v1/prices/snapshot.ndjson.gz.
Authorizations
Authorization
string
header
required
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.
Headers
If-None-Match
string
Conditional request. Pass the ETag from a previous download to receive 304 if unchanged.
If-Modified-Since
string
Conditional request by the previous Last-Modified value.
Response
Gzipped NDJSON. Each decompressed line is one Listing JSON object.
The response is of type file.
⌘I
Every buyable listing in one file (gzipped NDJSON)
{
"code": "missing_api_key",
"detail": "Provide your API key via `Authorization: Bearer csb_pub_…`. Generate one at https://csboard.com/profile?tab=api"
}
{"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.4131","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":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/get-listings-snapshot","slug":"/api-reference/get-listings-snapshot","pageMetadata":{"title":"GET /v1/listings/snapshot.ndjson.gz — Every Listing in One File","sidebarTitle":"GET /listings/snapshot","description":"Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.","openapi":"GET /listings/snapshot.ndjson.gz","href":"/api-reference/get-listings-snapshot"},"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: \"Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Every buyable listing as one gzipped NDJSON file. Each decompressed line is one `,_jsx(_components.code,{children:`Listing`}),` JSON object — the exact shape `,_jsx(_components.a,{href:`/api-reference/get-listings`,children:_jsx(_components.code,{children:`GET /v1/listings`})}),` returns, with the same one-listing-per-physical-skin rule and your negotiated discount already applied.`]}),`\n`,_jsxs(_components.p,{children:[`This is the way to hold a complete local copy of the shelf. Walking `,_jsx(_components.a,{href:`/api-reference/get-listings`,children:_jsx(_components.code,{children:`/v1/listings`})}),` page by page works for a filtered subset; for everything, it is tens of thousands of reads per pass. Download this file once instead, then open `,_jsx(_components.a,{href:`/api-reference/get-listings-stream`,children:_jsx(_components.code,{children:`/v1/listings/stream`})}),` from the position the file hands you, and your copy stays current from there.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Authentication required.`}),` Send your key as `,_jsx(_components.code,{children:`Authorization: Bearer csb_pub_...`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Limit:`}),` six full downloads per hour per key. A `,_jsx(_components.code,{children:`304`}),` answer to a conditional request is free.`]}),`\n`,_jsx(Heading,{level:`2`,id:`the-pairing-file-+-stream`,children:`The pairing: file + stream`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Download the file. Keep the `,_jsx(_components.code,{children:`ETag`}),` and the `,_jsx(_components.code,{children:`X-Stream-Position`}),` response headers.`]}),`\n`,_jsxs(_components.li,{children:[`Connect to `,_jsx(_components.code,{children:`/v1/listings/stream?last_event_id=\u003cX-Stream-Position>`}),`. The stream replays everything that happened since the file was built, then goes live. Apply `,_jsx(_components.code,{children:`new`}),` and `,_jsx(_components.code,{children:`update`}),` as an `,_jsxs(_components.strong,{children:[`upsert by `,_jsx(_components.code,{children:`id`})]}),` (a listing may already be in your copy) and `,_jsx(_components.code,{children:`gone`}),` as a delete. `,_jsx(_components.code,{children:`update`}),` carries reprices, so your copy keeps current prices without re-downloading.`]}),`\n`,_jsxs(_components.li,{children:[`Re-download on your own cadence — hourly is plenty — with `,_jsx(_components.code,{children:`If-None-Match`}),`. A reprice of a listing that was already live is not a stream event; the next file carries it. Between files a stale price is refused at checkout with `,_jsx(_components.code,{children:`price_moved`}),`, never filled.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If the stream answers `,_jsx(_components.code,{children:`resync`}),`, your position has aged out of its history: download the file again and reconnect from its new `,_jsx(_components.code,{children:`X-Stream-Position`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-headers`,children:`Request headers`}),`\n`,_jsx(ParamField,{header:`If-None-Match`,type:`string`,id:`param-if-none-match`,children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`ETag`}),` from your previous download. Unchanged → `,_jsx(_components.code,{children:`304 Not Modified`}),`, no body, no charge against the hourly limit.`]})}),`\n`,_jsx(ParamField,{header:`If-Modified-Since`,type:`string`,id:`param-if-modified-since`,children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`Last-Modified`}),` from your previous download. Same effect as `,_jsx(_components.code,{children:`If-None-Match`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response-headers`,children:`Response headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ETag`})}),_jsxs(_components.td,{children:[`Opaque version of this file. Send it back as `,_jsx(_components.code,{children:`If-None-Match`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Last-Modified`})}),_jsx(_components.td,{children:`When this file was built (HTTP date).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-Snapshot-At`})}),_jsx(_components.td,{children:`The same build time, ISO-8601 with milliseconds.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-Stream-Position`})}),_jsxs(_components.td,{children:[`The stream event id to connect with (`,_jsx(_components.code,{children:`last_event_id`}),`) so nothing between this file and your live view is missed.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`X-Row-Count`})}),_jsx(_components.td,{children:`Number of listings in the file.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Encoding`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`gzip`}),` — the body is always compressed; `,_jsx(_components.code,{children:`Content-Length`}),` is the compressed size.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`response-body`,children:`Response body`}),`\n`,_jsxs(_components.p,{children:[`A gzip stream. Every decompressed line is a `,_jsx(_components.code,{children:`Listing`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`jsonl`,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:`jsonl`,children:_jsxs(_components.code,{language:`jsonl`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"000012e8-1f4a-4c2b-9d3e-7a1b2c3d4e5f\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"market_hash_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AK-47 | Redline (Field-Tested)\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"wear\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Field-Tested\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"doppler_phase\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"float_value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.2613`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"paint_seed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`661`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"stickers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:[{`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Sticker | Natus Vincere | Katowice 2015\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"image\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"slot\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"wear\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.12`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}],`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"price_usd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`31.2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"category\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Rifle\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"rarity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Classified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"image\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"inspect_link\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"steam://rungame/730/…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"tradable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"tradable_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"delivery\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"instant\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"refund_percent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"listed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-20T09:14:02.481Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The file is not filtered: all three `,_jsx(_components.code,{children:`delivery`}),` buckets (`,_jsx(_components.code,{children:`instant`}),`, `,_jsx(_components.code,{children:`up_to_12h`}),`, `,_jsx(_components.code,{children:`hold`}),`) are in it. Filter on the field locally. It is rebuilt every 10 minutes while anyone is downloading it, CS2 only (`,_jsx(_components.code,{children:`appId`}),` is not read).`]}),`\n`,_jsx(Heading,{level:`2`,id:`example-download-then-stream-from-the-file’s-position`,children:`Example: download, then stream from the file’s position`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,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:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://csboard.com/v1/listings/snapshot.ndjson.gz \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer csb_pub_...\"`}),_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:` --dump-header headers.txt \\\\`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` --output listings.ndjson.gz`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`POS=$(grep -i `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'^x-stream-position'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` headers.txt | awk `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{print $2}'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` | tr -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'\\\\r'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -N `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://csboard.com/v1/listings/stream?last_event_id=$POS\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer csb_pub_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Accept: text/event-stream\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`example-conditional-re-download`,children:`Example: conditional re-download`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://csboard.com/v1/listings/snapshot.ndjson.gz \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer csb_pub_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'If-None-Match: \"lsnap-1792000000000-3900000\"'`}),_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:` --output listings.ndjson.gz`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`304`}),` means your file is the current one.`]}),`\n`,_jsx(Heading,{level:`2`,id:`responses-other-than-200`,children:`Responses other than 200`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`202`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`snapshot_building`})}),_jsxs(_components.td,{children:[`No file exists yet — the first minutes after a deploy. Retry after `,_jsx(_components.code,{children:`Retry-After`}),` seconds (also in `,_jsx(_components.code,{children:`retry_after_seconds`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`304`}),_jsx(_components.td,{children:_jsx(_components.em,{children:`(no body)`})}),_jsxs(_components.td,{children:[`Unchanged since the `,_jsx(_components.code,{children:`ETag`}),` or date you sent.`]})]}),_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:`Missing or invalid API key.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`snapshot_rate_limited`})}),_jsxs(_components.td,{children:[`More than six full downloads this hour. Send `,_jsx(_components.code,{children:`If-None-Match`}),` and take live changes from the stream.`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The price list by name — one row per `,_jsx(_components.code,{children:`market_hash_name`}),` with its cheapest ask — is a different, much smaller file: `,_jsx(_components.a,{href:`/api-reference/get-prices-snapshot`,children:_jsx(_components.code,{children:`GET /v1/prices/snapshot.ndjson.gz`})}),`.`]})})]})}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/snapshot.ndjson.gz — Every Listing in One File","sidebarTitle":"GET /listings/snapshot","description":"Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.","openapi":"GET /listings/snapshot.ndjson.gz","href":"/api-reference/get-listings-snapshot"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The pairing: file + stream","slug":"the-pairing-file-+-stream","depth":2,"children":[]},{"title":"Request headers","slug":"request-headers","depth":2,"children":[]},{"title":"Response headers","slug":"response-headers","depth":2,"children":[]},{"title":"Response body","slug":"response-body","depth":2,"children":[]},{"title":"Example: download, then stream from the file’s position","slug":"example-download-then-stream-from-the-file’s-position","depth":2,"children":[]},{"title":"Example: conditional re-download","slug":"example-conditional-re-download","depth":2,"children":[]},{"title":"Responses other than 200","slug":"responses-other-than-200","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Market data"],"summary":"Every buyable listing in one file (gzipped NDJSON)","description":"Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.","operationId":"getListingsSnapshot","parameters":["781a03f5-4e1f-460e-8c4d-d31aaee7726a","f1cc9403-d1d5-48fe-b083-4c11f2c499f7"],"responses":{"200":"728cdf20-c246-4132-adc6-af2cffb0c47e","202":"8e22742e-8274-4731-9ab2-4e12c7b97d76","304":"89d133ef-c3be-4493-ab8d-170ddebfbbf6","401":"f5237413-2b4f-46dc-b9f6-01427d143d08","429":"79b180e2-3bed-441a-97d2-b74cb08785b1"},"method":"get","type":"path","servers":["0e703a7c-bb72-4382-a5c4-7af713801e30"],"security":["06dc2d5d-3307-4e9d-932f-2c2f29b1a6df"],"path":"/listings/snapshot.ndjson.gz","baseUrlOptions":["https://csboard.com/v1"],"title":"Every buyable listing in one file (gzipped NDJSON)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"781a03f5-4e1f-460e-8c4d-d31aaee7726a":{"name":"If-None-Match","in":"header","description":"Conditional request. Pass the ETag from a previous download to receive 304 if unchanged.","schema":{"type":"string","description":"Conditional request. Pass the ETag from a previous download to receive 304 if unchanged.","uniqueKey":"","typeLabel":"string"}},"f1cc9403-d1d5-48fe-b083-4c11f2c499f7":{"name":"If-Modified-Since","in":"header","description":"Conditional request by the previous Last-Modified value.","schema":{"type":"string","description":"Conditional request by the previous Last-Modified value.","uniqueKey":"","typeLabel":"string"}}},"responses":{"728cdf20-c246-4132-adc6-af2cffb0c47e":{"description":"Gzipped NDJSON. Each decompressed line is one Listing JSON object.","headers":{"ETag":{"description":"Opaque snapshot version. Send back as If-None-Match to skip unchanged downloads.","schema":{"type":"string"}},"Last-Modified":{"description":"When this snapshot was built.","schema":{"type":"string"}},"X-Stream-Position":{"description":"The /listings/stream event id to connect with (`last_event_id`) so nothing between this file and your live view is missed.","schema":{"type":"string"}},"X-Row-Count":{"description":"Number of listings in the file.","schema":{"type":"integer"}},"X-Snapshot-At":{"description":"Build time, ISO-8601 with milliseconds.","schema":{"type":"string"}}},"content":{"application/x-ndjson":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"},"8e22742e-8274-4731-9ab2-4e12c7b97d76":{"description":"No snapshot exists yet (the first minutes after a deploy). Body `{ code: \"snapshot_building\", retry_after_seconds }`; retry after `Retry-After` seconds.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"89d133ef-c3be-4493-ab8d-170ddebfbbf6":{"description":"Not Modified — the snapshot has not changed since the ETag or date you sent.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"f5237413-2b4f-46dc-b9f6-01427d143d08":{"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"},"79b180e2-3bed-441a-97d2-b74cb08785b1":{"description":"`snapshot_rate_limited` — more than six full downloads this hour. Send If-None-Match and take live changes from the stream.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"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/snapshot.ndjson.gz — Every Listing in One File - CSBoard API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/get-listings-snapshot","matchLevel":0},"ru":{"href":"/ru/introduction","matchLevel":4},"zh-Hans":{"href":"/zh-Hans/introduction","matchLevel":4}}},"lastModified":"2026-10-26T15:00:02.635Z","originalFileLocation":"api-reference/get-listings-snapshot.mdx","locale":"en"},"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=\"Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.\">\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/snapshot.ndjson.gz — Every Listing in One File - CSBoard API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CSBoard API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api.csboard.com/api-reference/get-listings-snapshot\">\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=Market+Data\u0026amp;title=GET+%2Fv1%2Flistings%2Fsnapshot.ndjson.gz+%E2%80%94+Every+Listing+in+One+File\u0026amp;description=Download+every+buyable+CSBoard+listing+as+one+gzipped+NDJSON+file%2C+then+keep+it+current+from+the+SSE+stream.+The+replacement+for+paging+the+whole+catalogue.\u0026amp;theme=932e691933583ab42431355a\u0026amp;signature=bd785730260b3493a240f468a5cd98613c1441e7943de711ba76ad787f5833b7\">\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/snapshot.ndjson.gz — Every Listing in One File - CSBoard API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://csboard.mintlify.site/_mintlify/api/og/v2?division=Market+Data\u0026amp;title=GET+%2Fv1%2Flistings%2Fsnapshot.ndjson.gz+%E2%80%94+Every+Listing+in+One+File\u0026amp;description=Download+every+buyable+CSBoard+listing+as+one+gzipped+NDJSON+file%2C+then+keep+it+current+from+the+SSE+stream.+The+replacement+for+paging+the+whole+catalogue.\u0026amp;theme=932e691933583ab42431355a\u0026amp;signature=bd785730260b3493a240f468a5cd98613c1441e7943de711ba76ad787f5833b7\">\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/api-reference/get-listings-snapshot\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-listings-snapshot.md\">\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/api-reference/get-listings-snapshot#webpage\",\"url\":\"https://api.csboard.com/api-reference/get-listings-snapshot\",\"name\":\"GET /v1/listings/snapshot.ndjson.gz — Every Listing in One File\",\"description\":\"Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.\",\"dateModified\":\"2026-10-26T15:00:02.635Z\",\"isPartOf\":{\"@id\":\"https://api.csboard.com#website\"},\"breadcrumb\":{\"@id\":\"https://api.csboard.com/api-reference/get-listings-snapshot#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api.csboard.com/api-reference/get-listings-snapshot#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Market Data\",\"item\":\"https://api.csboard.com/api-reference/get-listings\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"GET /v1/listings/snapshot.ndjson.gz — Every Listing in One File\",\"item\":\"https://api.csboard.com/api-reference/get-listings-snapshot\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api.csboard.com/api-reference/get-listings-snapshot#apireference\",\"headline\":\"GET /v1/listings/snapshot.ndjson.gz — Every Listing in One File\",\"name\":\"GET /v1/listings/snapshot.ndjson.gz — Every Listing in One File\",\"description\":\"Download every buyable CSBoard listing as one gzipped NDJSON file, then keep it current from the SSE stream. The replacement for paging the whole catalogue.\",\"url\":\"https://api.csboard.com/api-reference/get-listings-snapshot\",\"mainEntityOfPage\":{\"@id\":\"https://api.csboard.com/api-reference/get-listings-snapshot#webpage\"},\"dateModified\":\"2026-10-26T15:00:02.635Z\",\"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":"/api-reference/get-listings-snapshot.md","siteName":"CSBoard API","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Market Data","pages":[{"title":"GET /v1/listings — Browse Live CS2 Marketplace Listings","sidebarTitle":"GET /listings","openapi":"GET /listings","href":"/api-reference/get-listings"},{"title":"GET /v1/listings/depth — One Item's Whole Book, Live","sidebarTitle":"GET /listings/depth","openapi":"GET /listings/depth","href":"/api-reference/get-listings-depth"},{"title":"GET /v1/listings/stream — Live Feed of New and Sold Listings","sidebarTitle":"GET /listings/stream","description":"Subscribe to CS2 listings the moment they appear and the moment they sell, over Server-Sent Events. Replaces polling, and tells you when items disappear.","openapi":"GET /listings/stream","href":"/api-reference/get-listings-stream"},{"title":"GET /v1/listings/snapshot.ndjson.gz — Every Listing in One File","sidebarTitle":"GET /listings/snapshot","openapi":"GET /listings/snapshot.ndjson.gz","href":"/api-reference/get-listings-snapshot"},{"title":"GET /v1/listings/availability — Bulk Availability Check","sidebarTitle":"GET /listings/availability","description":"Check whether up to 100 CSBoard listings are still buyable in a single request, with the live price of each available id and a list of unavailable ids.","openapi":"GET /listings/availability","href":"/api-reference/get-listings-availability"},{"title":"GET /v1/games — Games You Can Pass as appId","sidebarTitle":"GET /games","openapi":"GET /games","href":"/api-reference/get-games"},{"title":"GET /v1/prices — CS2 minAsk Price List by Item Group","sidebarTitle":"GET /prices","openapi":"GET /prices","href":"/api-reference/get-prices"},{"title":"GET /v1/prices/snapshot.ndjson.gz — Full Price Snapshot","sidebarTitle":"GET /prices/snapshot","openapi":"GET /prices/snapshot.ndjson.gz","href":"/api-reference/get-prices-snapshot"},{"title":"GET /v1/public/prices — Keyless Min-Ask Feed for CS2, Dota 2 and Rust","sidebarTitle":"GET /public/prices","openapi":"GET /public/prices","href":"/api-reference/get-public-prices"},{"title":"GET /v1/currency — FX Rates for USD Price Conversion","sidebarTitle":"GET /currency","openapi":"GET /currency","href":"/api-reference/get-currency"}]},{"group":"Trading","pages":[{"title":"POST /v1/orders — Buy CS2 Listings from Your Balance","sidebarTitle":"POST /orders","openapi":"POST /orders","href":"/api-reference/post-orders"},{"title":"POST /v1/market/buy — Buy and Deliver to a Steam Trade URL","sidebarTitle":"POST /market/buy","openapi":"POST /market/buy","href":"/api-reference/post-market-buy"},{"title":"POST /v1/orders/:id/claim — Release a Held Order","sidebarTitle":"POST /orders/:id/claim","openapi":"POST /orders/{id}/claim","href":"/api-reference/post-orders-claim"},{"title":"POST /v1/orders/:id/cancel — Cancel an Undelivered Order","sidebarTitle":"POST /orders/:id/cancel","openapi":"POST /orders/{id}/cancel","href":"/api-reference/post-orders-cancel"},{"title":"GET /v1/orders — List Your Purchase History","sidebarTitle":"GET /orders","openapi":"GET /orders","href":"/api-reference/get-orders"},{"title":"GET /v1/orders/info — Batch Order Lookup","sidebarTitle":"GET /orders/info","openapi":"GET /orders/info","href":"/api-reference/get-orders-info"},{"title":"GET /v1/orders/{id} — Fetch a Single Order","sidebarTitle":"GET /orders/{id}","openapi":"GET /orders/{id}","href":"/api-reference/get-order"}]},{"group":"Instant Sell","pages":[{"title":"GET /v1/sell/status: Is Instant Sell Enabled for My Key?","sidebarTitle":"GET /sell/status","openapi":"GET /sell/status","href":"/api-reference/get-sell-status"},{"title":"POST /v1/sell/quotes: Quote a Steam Inventory for Instant Sell","sidebarTitle":"POST /sell/quotes","openapi":"POST /sell/quotes","href":"/api-reference/post-sell-quotes"},{"title":"POST /v1/sell/orders: Sell Items from a Steam Inventory","sidebarTitle":"POST /sell/orders","openapi":"POST /sell/orders","href":"/api-reference/post-sell-orders"},{"title":"GET /v1/sell/orders: List Your Instant Sell Orders","sidebarTitle":"GET /sell/orders","openapi":"GET /sell/orders","href":"/api-reference/get-sell-orders"},{"title":"GET /v1/sell/orders/{id}: One Instant Sell Order","sidebarTitle":"GET /sell/orders/{id}","openapi":"GET /sell/orders/{id}","href":"/api-reference/get-sell-order"},{"title":"POST /v1/sell/orders/{id}/cancel: Cancel an Instant Sell Order","sidebarTitle":"POST /sell/orders/{id}/cancel","openapi":"POST /sell/orders/{id}/cancel","href":"/api-reference/post-sell-order-cancel"}]},{"group":"P2P","pages":[{"title":"GET /v1/p2p/inventory — Your CS2 Inventory, Ready to List","sidebarTitle":"GET /p2p/inventory","openapi":"GET /p2p/inventory","href":"/api-reference/get-p2p-inventory"},{"title":"POST /v1/p2p/listings — List Your CS2 Items on the P2P Market","sidebarTitle":"POST /p2p/listings","openapi":"POST /p2p/listings","href":"/api-reference/post-p2p-listings"},{"title":"GET /v1/p2p/listings — Your P2P Listings","sidebarTitle":"GET /p2p/listings","openapi":"GET /p2p/listings","href":"/api-reference/get-p2p-listings"},{"title":"PATCH /v1/p2p/listings/{id} — Change a Listing's Price","sidebarTitle":"PATCH /p2p/listings/{id}","openapi":"PATCH /p2p/listings/{id}","href":"/api-reference/patch-p2p-listing"},{"title":"DELETE /v1/p2p/listings/{id} — Remove a P2P Listing","sidebarTitle":"DELETE /p2p/listings/{id}","openapi":"DELETE /p2p/listings/{id}","href":"/api-reference/delete-p2p-listing"}]},{"group":"Account","pages":[{"title":"GET /v1/balance — Account Balance and Trading Status","sidebarTitle":"GET /balance","openapi":"GET /balance","href":"/api-reference/get-balance"},{"title":"GET /v1/transactions — Your Balance Ledger","sidebarTitle":"GET /transactions","openapi":"GET /transactions","href":"/api-reference/get-transactions"},{"title":"GET /v1/stats — Your Delivery and Refund Record","sidebarTitle":"GET /stats","openapi":"GET /stats","href":"/api-reference/get-stats"},{"title":"GET /v1/key — Inspect Your API Key","sidebarTitle":"GET /key","openapi":"GET /key","href":"/api-reference/get-key"},{"title":"PUT /v1/key/allowed-ips — Restrict a Key to Your Servers","sidebarTitle":"PUT /key/allowed-ips","openapi":"PUT /key/allowed-ips","href":"/api-reference/put-key-allowed-ips"}]},{"group":"Webhooks","pages":[{"title":"GET /v1/webhooks — List Your Webhook Endpoints","sidebarTitle":"GET /webhooks","openapi":"GET /webhooks","href":"/api-reference/get-webhooks"},{"title":"POST /v1/webhooks — Register a Webhook Endpoint","sidebarTitle":"POST /webhooks","openapi":"POST /webhooks","href":"/api-reference/post-webhooks"},{"title":"PATCH /v1/webhooks/{id} — Update a Webhook Endpoint","sidebarTitle":"PATCH /webhooks/{id}","openapi":"PATCH /webhooks/{id}","href":"/api-reference/patch-webhook"},{"title":"DELETE /v1/webhooks/{id} — Remove a Webhook Endpoint","sidebarTitle":"DELETE /webhooks/{id}","openapi":"DELETE /webhooks/{id}","href":"/api-reference/delete-webhook"},{"title":"POST /v1/webhooks/{id}/test — Send a Test Event","sidebarTitle":"POST /webhooks/{id}/test","openapi":"POST /webhooks/{id}/test","href":"/api-reference/post-webhook-test"},{"title":"POST /v1/webhooks/{id}/rotate-secret — Rotate the Signing Secret","sidebarTitle":"POST /webhooks/{id}/rotate-secret","openapi":"POST /webhooks/{id}/rotate-secret","href":"/api-reference/post-webhook-rotate-secret"},{"title":"GET /v1/webhooks/{id}/deliveries — Delivery History","sidebarTitle":"GET /webhooks/{id}/deliveries","openapi":"GET /webhooks/{id}/deliveries","href":"/api-reference/get-webhook-deliveries"},{"title":"POST /v1/webhooks/{id}/deliveries/{deliveryId}/retry — Retry a Delivery","sidebarTitle":"POST …/retry","openapi":"POST /webhooks/{id}/deliveries/{deliveryId}/retry","href":"/api-reference/post-webhook-delivery-retry"}]},{"group":"Status","pages":[{"title":"GET /v1/health — CSBoard API Liveness and Freshness Probe","sidebarTitle":"GET /health","openapi":"GET /health","href":"/api-reference/get-health"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/overview"}]}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/introduction"}]},{"language":"zh-Hans","pages":[{"title":"zh-Hans","href":"/zh-Hans/introduction"}]}]},"basePath":"","title":"GET /v1/listings/snapshot.ndjson.gz — Every Listing in One File - CSBoard API","buildId":"dpl_5joLUXmnJgwqjrHAS4dxZrQTdxgh","deploymentId":"dpl_5joLUXmnJgwqjrHAS4dxZrQTdxgh","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DPDWPCdE.js","utils-DyjUHyLo.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BWYE1cdS.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-COAzxpEw.js","snippetPresets-DNiD_S52.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DDHbuAIY.js","ApiExamples-CjwVt80x.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ByHQMk7z.js","shallow-CaZuw1AO.js","getApiPlaygroundDisplay-DPVPOknm.js","CodeSnippet-B31CH-Mp.js","CodeSnippets-BxTYZWz6.js","getPastedJson-DhoAwiNO.js","icon-Dhq8z75J.js","MethodPill-DLXmKOwr.js","DuplicateIcon-jzdVwyRU.js","createIcon-eD0b3klN.js","DynamicMarkdown-BfddVCX7.js","SectionHeading-2pSCIo17.js","axios-vUo_bRtp.js","Markdown-DsWjhwJ4.js","clsx-B2t_mZQG.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CUljsAY7.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Cf70306N.js"]}