← Codexery

Codexery Data API

Structured JSON for 9,435 reference sites and 266,554 entities, every entity with its sources, plus the Sacred Atlas compilation dataset. The catalogue is free. Data routes are paid per request in USDC on Base through the x402 protocol: no account, no API key.

How to pay

Request any priced route. The server answers 402 with a PAYMENT-REQUIRED header that states the price, the network (eip155:8453) and the receiving address. An x402 client (for example @x402/fetch for Node, or any agent framework with x402 support) signs the USDC transfer and retries with PAYMENT-SIGNATURE; the response then carries the data. Species codexes (species-*) are free because their source data is CC BY-NC.

curl https://api.codexery.com/v1/sites                      # free catalogue
curl -i https://api.codexery.com/v1/entity/lost-civilizations/lost-civilizations/cahokia   # 402 + PAYMENT-REQUIRED

Routes

RouteWhat you getPrice
GET /Service description (free)free
GET /v1/sitesCatalogue of every site with entity counts per category (free)free
GET /v1/site/{site}Categories + entity name list for one site$0.005
GET /v1/site/{site}/{category}Full category data: every entity with sources$0.005
GET /v1/entity/{site}/{category}/{id}One entity$0.002
GET /v1/searchSearch entity names across the whole network (max 50 hits)$0.01
GET /v1/sacredatlasSacred Atlas dataset catalogue (free)free
GET /v1/sacredatlas/data/{dataset}A whole Sacred Atlas compilation dataset$0.01
GET /v1/sacredatlas/record/{dataset}/{id}One compilation record$0.002
GET /v1/sacredatlas/text/{work}/{book}One book of a public-domain scripture text$0.005
GET /v1/sacredatlas/crossrefs/{book}Verse-level cross-tradition links for one book$0.005
GET /v1/sacredatlas/commentary/{source}/{file}One chapter of public-domain commentary$0.002

Machine-readable: /openapi.json · policy for AI agents: /llms.txt

Licence and attribution

Entry text is adapted from Wikipedia and other listed sources under CC BY-SA 4.0; credit "Codexery (codexery.com)" with a link when you publish or display it. The same entry data is published free on each site at https://codexery.com/<codex>/data/content/<category>.json; the API adds search, per-entity routes, the network-wide index and the licence-checked Sacred Atlas dataset (docs).