Gembook Assets API
The assets API from Gembook — 3 operation(s) for assets.
The assets API from Gembook — 3 operation(s) for assets.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/gembook-xyz:gembook-xyz-assets-api"
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.
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: 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>'