Developers

Public API for cectoken.com

cectoken.com exposes a public, read-only JSON API. Search the token catalog, fetch pricing and sales history, browse brand entities and guides — build catalog tools, price trackers, AI agents, or anything else. No authentication required.

OpenAPI spec API catalog Agent skills llms.txt

Quick start

Try the catalog search:

curl 'https://cectoken.com/api/v1/items/search?q=showbiz' \
  -H 'Accept: application/json'

Base URL: https://cectoken.com/api/v1

Authentication & limits

Authentication: None — the API is fully public and read-only.
Rate limit: 60 requests / minute / IP. 429 with Retry-After when exceeded.
CORS: Access-Control-Allow-Origin: * — browser-callable.
Caching: Cache-Control: public, max-age=300 on GET responses.

Endpoints

GET /api/v1/items/search

Search the catalog by keyword, brand, and/or composition. Paginated.

Query parameters: q (string), brand (id or slug), composition (string), per_page (1–100, default 25), page (default 1).

curl 'https://cectoken.com/api/v1/items/search?q=chuck&brand=chuck-e-cheese&per_page=10'

GET /api/v1/items/{slug}

Fetch a single token, including the fair-value estimate, peak/last sale, and 10 most-recent sales.

curl 'https://cectoken.com/api/v1/items/1977-prototype-token'

GET /api/v1/brands/{slug}

Fetch a brand (issuer) with catalog stats, aggregate sales, and top tokens.

curl 'https://cectoken.com/api/v1/brands/showbiz-pizza-place'

GET /api/v1/guides

List published guides. Optional category filter (cec, showbiz, discovery-zone, other-brands, how-to, market).

curl 'https://cectoken.com/api/v1/guides?category=how-to'

GET /api/v1/guides/{slug}

Fetch a published guide including its full markdown content (in the content_markdown field).

curl 'https://cectoken.com/api/v1/guides/how-to-identify-a-cec-token'

Markdown content negotiation

The same item, brand, and guide pages that serve HTML also return a Markdown representation when called with Accept: text/markdown. Useful for LLM ingestion, scraping, or terminal use.

curl -H 'Accept: text/markdown' \
  'https://cectoken.com/guides/how-to-identify-a-cec-token'

The same negotiation works on /items/{slug} and /brands/{slug}. HTML remains the default for browsers.

Discovery files

AI agents and automated clients can discover the API surface via well-known files:

/openapi.json — OpenAPI 3.1 specification for all endpoints.
/.well-known/api-catalog — RFC 9727 linkset.
/.well-known/agent-skills/index.json — Agent Skills Discovery v0.2.0 manifest.
/.well-known/http-message-signatures-directory — placeholder for future request signing.
/auth.md — agent authentication documentation.
/llms.txt — site index for LLMs.
/robots.txt — crawler policy with Content-Signal directives.
/sitemap.xml — full URL inventory.

Browser / agent integration

Pages on cectoken.com also register WebMCP tools via navigator.modelContext when supported. In-page AI agents can call search_tokens, view_token, view_brand, list_guides, and view_guide without re-implementing HTTP calls.

Questions or integration help?

Reach us at /contact, or email [email protected]. We're happy to hear about what you're building.