Gembook Assets API

The assets API from Gembook — 3 operation(s) for assets.

GitHub OpenAPI

Operations 3

GET /v1/assets/{slug} Canonical asset, release-selected valuation + published Gembook Value #
GET /v1/assets/{slug}/comps Paged sold comps for an asset #
GET /v1/assets/{slug}/listings Live listings for an asset, with trust signals #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/gembook-xyz:gembook-xyz-assets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gembook-xyz-assets-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Gembook Assets API
  version: 1.5.0
  description: 'Public read API for Gembook canonical card data: assets, comps, listings, methodology, and source registry. Per docs/specs/PHASE-2-SCHEMA-API.md.'
servers:
- url: https://gembook.xyz/api
tags:
- name: Assets
paths:
  /v1/assets/{slug}:
    get:
      summary: Canonical asset, release-selected valuation + published Gembook Value
      security:
      - ApiKeyAuth: []
      tags:
      - Assets
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Asset resource in the existing data/meta/links envelope, including when only its valuation release is unavailable.
          content:
            application/json:
              schema:
                type: object
                required:
                - data
                - meta
                - links
                properties:
                  data:
                    type: object
                    properties:
                      asset:
                        type: object
                        description: Canonical asset identity, preserved when its valuation release is unavailable.
                      valuation:
                        type:
                        - object
                        - 'null'
                        description: The selected valuation row, which may itself have a null fair_value. Null for a healthy scoped miss or an unavailable release; valuation_status distinguishes them. No other release or unscoped row is used as a fallback.
                      valuation_status:
                        type: string
                        enum:
                        - available
                        - no_value
                        - unavailable
                        description: 'available: a row was selected, even if fair_value is null; no_value: the valid captured release/run has no row; unavailable: the pointer, release or valuation storage could not be read or validated.'
                      raw:
                        type:
                        - object
                        - 'null'
                        description: Independent raw anchor; preserved when the valuation release is unavailable.
                      gembook_value:
                        type:
                        - object
                        - 'null'
                        description: Independently gated published Gembook Value; preserved when the valuation release is unavailable.
                  meta:
                    type: object
                    required:
                    - version
                    - computed_at
                    - engine_version
                    - request_id
                    properties:
                      version:
                        type: string
                        const: v1
                      computed_at:
                        type: string
                        format: date-time
                      engine_version:
                        type: integer
                      request_id:
                        type: string
                  links:
                    type: object
                    required:
                    - self
                    properties:
                      self:
                        type: string
                      related:
                        type: object
                        additionalProperties:
                          type: string
          headers:
            Cache-Control:
              description: Set to no-store only when valuation_status is unavailable. Healthy available and no_value responses retain their existing cache behavior.
              schema:
                type: string
                const: no-store
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '403':
          description: Key lacks required scope
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '404':
          description: Asset not found
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '429':
          description: Rate limit exceeded
          headers:
            Retry-After:
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
      operationId: getV1AssetsBySlug
      x-operation-id-source: derived
  /v1/assets/{slug}/comps:
    get:
      summary: Paged sold comps for an asset
      security:
      - ApiKeyAuth: []
      tags:
      - Assets
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: since
        in: query
        schema:
          type: string
          format: date-time
      - name: status
        in: query
        schema:
          type: string
          enum:
          - active
          - superseded
          - quarantined
          - manual_review
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 200
      - name: cursor
        in: query
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                - data
                - meta
                - links
                properties:
                  data:
                    type: object
                  meta:
                    type: object
                    required:
                    - version
                    - computed_at
                    - engine_version
                    - request_id
                    properties:
                      version:
                        type: string
                        const: v1
                      computed_at:
                        type: string
                        format: date-time
                      engine_version:
                        type: integer
                      request_id:
                        type: string
                  links:
                    type: object
                    required:
                    - self
                    properties:
                      self:
                        type: string
                      related:
                        type: object
                        additionalProperties:
                          type: string
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '403':
          description: Key lacks required scope
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '429':
          description: Rate limit exceeded
          headers:
            Retry-After:
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
      operationId: getV1AssetsBySlugComps
      x-operation-id-source: derived
  /v1/assets/{slug}/listings:
    get:
      summary: Live listings for an asset, with trust signals
      security:
      - ApiKeyAuth: []
      tags:
      - Assets
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: include_flagged
        in: query
        schema:
          type: boolean
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 200
          default: 50
      - name: cursor
        in: query
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                - data
                - meta
                - links
                properties:
                  data:
                    type: object
                  meta:
                    type: object
                    required:
                    - version
                    - computed_at
                    - engine_version
                    - request_id
                    properties:
                      version:
                        type: string
                        const: v1
                      computed_at:
                        type: string
                        format: date-time
                      engine_version:
                        type: integer
                      request_id:
                        type: string
                  links:
                    type: object
                    required:
                    - self
                    properties:
                      self:
                        type: string
                      related:
                        type: object
                        additionalProperties:
                          type: string
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '403':
          description: Key lacks required scope
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '429':
          description: Rate limit exceeded
          headers:
            Retry-After:
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: object
                    required:
                    - code
                    - message
                    - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
      operationId: getV1AssetsBySlugListings
      x-operation-id-source: derived
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: 'API key issued via the operator CLI. Format: gemb_<48 char base64url>'