> ## Documentation Index > Fetch the complete documentation index at: https://catchbackcards.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Price history > **Scope:** `read:catalog` A card's daily CardLadder value estimates, oldest first. A point is the raw reading, so the latest can differ from the card's `market_value`. A card that has never been priced returns an empty list. Cached for up to five minutes. ## OpenAPI ````yaml /partner-api/openapi.yaml get /api/partner/v1/cards/{id}/price-history openapi: 3.1.0 info: title: CatchBack Partner API version: 1.0.0 summary: Open packs, trade cards, read card data and ship vaulted cards. description: >- The Partner API acts on one CatchBack account with its real CatchCoins balance. Several operations here move money or data, so read [Idempotency](/partner-api/idempotency) before you call them. Error bodies are JSON with a human-readable `error` and, where you might branch on it, a machine-readable `code`. Branch on the status and the `code`, because the `error` text can change. New fields can be added to any response. contact: name: CatchBack support email: catchbackcards@gmail.com servers: - url: https://catchbackcards.com description: Production. Every call acts on real money and real inventory. security: - bearerAuth: [] tags: - name: Gacha description: Open packs, see what they can pull, check a pull, and sell cards back. - name: Marketplace description: Search and buy cards, and manage your own listings. - name: Metadata description: Look cards up by id or cert, with price history and recent activity. - name: Shipping description: Estimate, create and track shipments of cards you hold. - name: Account description: Your key, balance, limits, vault and order history, across every rail. - name: Funding description: Deposit and withdraw your balance in USDC. - name: Testing description: Test logins for trying CatchBack without real money. - name: Webhooks description: Signed POSTs we send to your URL when something happens on your account. paths: /api/partner/v1/cards/{id}/price-history: get: tags: - Metadata summary: Price history description: >- **Scope:** `read:catalog` A card's daily CardLadder value estimates, oldest first. A point is the raw reading, so the latest can differ from the card's `market_value`. A card that has never been priced returns an empty list. Cached for up to five minutes. operationId: getPriceHistory parameters: - $ref: '#/components/parameters/CardId' - $ref: '#/components/parameters/LookupCategory' - $ref: '#/components/parameters/HistoryDays' responses: '200': description: The readings. content: application/json: schema: type: object required: - card_id - category - days - since - points properties: card_id: type: string category: type: string days: type: integer since: type: string format: date-time points: type: array items: type: object required: - recorded_at - estimated_value - source properties: recorded_at: type: string estimated_value: type: number description: USD. source: type: string description: e.g. `cardladder`. example: card_id: 0e94dc61-… category: pokemon days: 90 since: '2026-07-30T18:00:00.000Z' points: - recorded_at: '2026-10-27T17:05:02Z' estimated_value: 398.5 source: cardladder - recorded_at: '2026-10-28T17:04:11Z' estimated_value: 410 source: cardladder '400': description: A malformed card id, an unknown `category`, or `days` outside 1–365. content: application/json: schema: $ref: '#/components/schemas/Error' '401': $ref: '#/components/responses/Unauthorized' '403': description: The key lacks `read:catalog`. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: No card has this id. content: application/json: schema: $ref: '#/components/schemas/Error' '500': $ref: '#/components/responses/ServerError' security: - bearerAuth: - read:catalog components: parameters: CardId: name: id in: path required: true description: 'A card id: `item.id` or `card_id` from any other endpoint.' schema: type: string pattern: ^[A-Za-z0-9_-]{1,128}$ example: 0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e LookupCategory: name: category in: query description: >- The card's catalog, if you know it. Without it, every catalog is searched. schema: $ref: '#/components/schemas/CardCategory' HistoryDays: name: days in: query description: How many days back from now. Outside 1–365 is a `400`. schema: type: integer minimum: 1 maximum: 365 default: 90 schemas: Error: type: object required: - error properties: error: type: string description: >- For people. The text can change, so branch on the status and the `code`. code: type: string description: Machine-readable, where you might branch on it. CardCategory: type: string description: A card's catalog. `goods` is luxury goods and `singles` is raw singles. enum: - pokemon - onepiece - sports - riftbound - watches - goods - singles responses: Unauthorized: description: A missing, malformed, disabled or unknown API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Missing or malformed API key ServerError: description: An error on our side. Retry with backoff. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: cb_live_<48 hex> description: >- Your API key, sent as a bearer token. Keep it on your server. See [Authentication](/partner-api/authentication). A request from a location we refuse gets a `403` with `Access denied`, whether or not it has a valid key: [where you can call from](/partner-api/errors-and-limits#where-you-can-call-from). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.