Glyph Mints API
The Mints API from Glyph — 3 operation(s) for mints.
The Mints API from Glyph — 3 operation(s) for mints.
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/glyphapi-dev:glyphapi-dev-mints-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: Glyph Mints API
description: 'A language for agents: encode content into the cheapest substrate the reading model can parse, with honest per-reader token math. Fillin is the retrieval product — a time-series index of the dev internet that closes the gap between an LLM''s training cutoff and now.'
version: 0.1.0
tags:
- name: Mints
paths:
/v1/mints:
post:
summary: Create Mint
description: 'Mint an information asset. Returns the signed mint payload.
Fillin verifies every `evidence[].chunk_id` resolves to a real corpus
row, validates the typed reasoning graph, then HMAC-signs the canonical
payload. The returned `attestation` is what buyers verify; it''s also
what makes the asset listable on the marketplace.'
operationId: create_mint_v1_mints_post
security:
- HTTPBearer: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MintIn'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Mints
get:
summary: Search Mints
description: 'Search the marketplace by fingerprint. Exact-match on
(model_family, cutoff_quarter, cluster_id) — the cluster wildcard ''*''
is what minters get before the daily clustering job runs.'
operationId: search_mints_v1_mints_get
parameters:
- name: model_family
in: query
required: true
schema:
type: string
title: Model Family
- name: cutoff_quarter
in: query
required: true
schema:
type: string
title: Cutoff Quarter
- name: cluster_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cluster Id
- name: only_for_sale
in: query
required: false
schema:
type: boolean
default: true
title: Only For Sale
- name: limit
in: query
required: false
schema:
type: integer
default: 20
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Mints
/v1/mints/{mint_id}:
get:
summary: Get Mint
description: 'Public read of a minted asset. No auth, no charge — discovery is free.
Future: the heavy `reasoning_graph` field gets paywalled by a separate
`/v1/mints/{id}/buy` flow once the marketplace ships. For now everything
is visible so we can prove the attestation contract end-to-end.'
operationId: get_mint_v1_mints__mint_id__get
parameters:
- name: mint_id
in: path
required: true
schema:
type: string
title: Mint Id
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Mints
/v1/mints/{mint_id}/buy:
post:
summary: Buy Mint
description: 'Buy a listed mint. Atomically debits the buyer''s bearer balance,
credits the seller''s bearer minus Fillin''s rake, records the transaction,
and returns the full mint payload (the typed reasoning_graph that was
paywalled to non-buyers in the future read endpoint).
Bearer-funded buyers only in MVP. Wallet-funded buyers will be added
once x402-out is wired; the seller MUST be a bearer-minter so we have
a SQLite balance to credit.'
operationId: buy_mint_v1_mints__mint_id__buy_post
security:
- HTTPBearer: []
parameters:
- name: mint_id
in: path
required: true
schema:
type: string
title: Mint Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BuyMintIn'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Mints
components:
schemas:
MintReasoningStepIn:
properties:
claim:
type: string
title: Claim
evidence_chunk_id:
type: string
title: Evidence Chunk Id
description: Must appear in `evidence`
confidence:
type: number
maximum: 1.0
minimum: 0.0
title: Confidence
derived_claim:
anyOf:
- type: string
- type: 'null'
title: Derived Claim
type: object
required:
- claim
- evidence_chunk_id
- confidence
title: MintReasoningStepIn
MintIn:
properties:
model_family:
type: string
title: Model Family
description: e.g. 'claude-opus-4-7', 'gpt-5'
cutoff_quarter:
type: string
title: Cutoff Quarter
description: e.g. '2026-Q1' — coarse for fungibility
query:
type: string
title: Query
description: The original question the agent asked Fillin
query_embedding:
anyOf:
- items:
type: number
type: array
- type: 'null'
title: Query Embedding
description: Optional 384-d MiniLM embedding of the query, for cluster routing
evidence:
items:
$ref: '#/components/schemas/MintEvidenceIn'
type: array
title: Evidence
description: Fillin chunk_ids the reasoning cites. Every id must resolve in the corpus.
reasoning_graph:
items:
$ref: '#/components/schemas/MintReasoningStepIn'
type: array
title: Reasoning Graph
description: Typed reasoning steps. Free-text is rejected — typed traces are the moat.
conclusion:
type: string
title: Conclusion
list_price_usdc:
anyOf:
- type: number
- type: 'null'
title: List Price Usdc
description: Price the minter wants to resell at. NULL = mint but don't list.
type: object
required:
- model_family
- cutoff_quarter
- query
- evidence
- reasoning_graph
- conclusion
title: MintIn
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
BuyMintIn:
properties:
model_family:
type: string
title: Model Family
description: Buyer's declared model context — registered alongside the buy
cutoff_quarter:
type: string
title: Cutoff Quarter
description: Buyer's declared cutoff — registered alongside the buy
type: object
required:
- model_family
- cutoff_quarter
title: BuyMintIn
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
MintEvidenceIn:
properties:
chunk_id:
type: string
title: Chunk Id
description: LanceDB row id Fillin will verify exists
url:
anyOf:
- type: string
- type: 'null'
title: Url
description: Convenience copy of the source URL
type: object
required:
- chunk_id
title: MintEvidenceIn
securitySchemes:
HTTPBearer:
type: http
scheme: bearer