> ## Documentation Index > Fetch the complete documentation index at: https://api.csboard.com/llms.txt > Use this file to discover all available pages before exploring further. # Live buyable listings > Live buyable listings across the marketplace — each with float, paint seed, stickers, and the asking price in USD. Use keyset pagination via `cursor`. ## OpenAPI ````yaml /openapi.json get /listings openapi: 3.1.0 info: title: CSBoard API version: 1.0.0 description: >- Market data over the CSBoard marketplace — live listings, floats, stickers, minAsk prices, FX rates — plus opt-in buying straight from your balance. Free to read, key-gated, built for automation. contact: name: CSBoard url: https://csboard.com/docs servers: - url: https://csboard.com/v1 description: Production security: - bearerAuth: [] tags: - name: Status description: Liveness and freshness probes. - name: Market data description: Read the live catalog, prices, and FX rates. - name: Trading description: Buy listings from your CSBoard balance. Opt-in, key-gated. - name: Account description: Your balance, settled funds, and trading status. paths: /listings: get: tags: - Market data summary: Live buyable listings description: >- Live buyable listings across the marketplace — each with float, paint seed, stickers, and the asking price in USD. Use keyset pagination via `cursor`. operationId: listListings parameters: - name: search in: query description: Full-text match on market hash name. schema: type: string - name: category in: query description: e.g. Rifle, Knife, Gloves. schema: type: string - name: wear in: query description: Item wear bucket. schema: type: string enum: - Factory New - Minimal Wear - Field-Tested - Well-Worn - Battle-Scarred - name: rarity in: query description: e.g. Classified, Covert. schema: type: string - name: min_price in: query description: Minimum price in USD. schema: type: number - name: max_price in: query description: Maximum price in USD. schema: type: number - name: min_float in: query description: Minimum float value. schema: type: number - name: max_float in: query description: Maximum float value. schema: type: number - name: stat_trak in: query description: Filter StatTrak™ items. schema: type: string enum: - only - exclude - name: souvenir in: query description: Filter Souvenir items. schema: type: string enum: - only - exclude - name: sort in: query description: Sort order. Default id. schema: type: string enum: - id - newest - price_asc - price_desc default: id - name: cursor in: query description: Keyset cursor from next_cursor. schema: type: string - name: limit in: query description: 1–200. Default 50. schema: type: integer minimum: 1 maximum: 200 default: 50 responses: '200': description: A page of listings. content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/Listing' next_cursor: type: - string - 'null' description: >- Pass back as `cursor` to fetch the next page. Null on the last page. required: - items - next_cursor example: items: - id: itm_8841201 market_hash_name: AK-47 | Redline (Minimal Wear) wear: Minimal Wear doppler_phase: null float_value: 0.0912 paint_seed: 412 stickers: - name: Crown (Foil) image: https://cdn.csboard.com/stickers/crown_foil.png slot: 0 wear: 0 price_usd: 14.37 category: Rifle rarity: Classified image: https://cdn.csboard.com/items/ak47_redline_mw.png inspect_link: >- steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20... tradable: false tradable_at: '2026-07-06T12:00:00Z' delivery: hold next_cursor: eyJpZCI6Iml0bV84ODQxMjAxIn0= '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' components: schemas: Listing: type: object properties: id: type: string description: Stable listing id. Pass to POST /v1/orders. market_hash_name: type: string wear: type: - string - 'null' enum: - Factory New - Minimal Wear - Field-Tested - Well-Worn - Battle-Scarred - null doppler_phase: type: - string - 'null' description: Doppler / Gamma Doppler phase, e.g. "Phase 2", "Ruby", or null. float_value: type: - number - 'null' paint_seed: type: - integer - 'null' stickers: type: array items: $ref: '#/components/schemas/Sticker' price_usd: type: number description: >- Authoritative asking price in USD. Equals the amount charged if you buy this listing. category: type: string rarity: type: string image: type: string format: uri inspect_link: type: string tradable: type: boolean tradable_at: type: - string - 'null' format: date-time description: When the item leaves trade hold. Null if already tradable. delivery: type: string enum: - instant - hold required: - id - market_hash_name - price_usd - category - delivery - stickers - tradable Sticker: type: object properties: name: type: string image: type: string format: uri slot: type: integer minimum: 0 maximum: 4 wear: type: - number - 'null' description: Sticker wear 0–1, or null if unscraped. required: - name - image - slot - wear Error: 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). properties: code: type: string description: >- Machine-readable error code, e.g. rate_limit_exceeded, trading_not_enabled, price_moved. detail: type: string description: Human-readable explanation. required: - code responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: unauthorized message: Missing or invalid API key. RateLimited: description: Rate limit exceeded. Includes a Retry-After header. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: code: rate_limit_exceeded message: Too many requests. securitySchemes: 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. ````