Live at glossary.ethereum.org.
Canonical Ethereum terminology glossary -- English style guide and translations for 24 languages.
Usage rules, casing conventions, avoid lists, and contextual translations. Built for content creators, translators, and translation pipelines.
- Interactive docs:
/docs - OpenAPI spec:
/openapi.json - LLM-friendly:
/llms.txt
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/style-guide |
Full English style guide |
| GET | /api/v1/style-guide/:termId |
Look up a term (intelligent matching) |
| GET | /api/v1/style-guide/search?q= |
Search terms and definitions |
| GET | /api/v1/translations/:lang |
Full glossary for a language |
| GET | /api/v1/translations/:lang/:termId |
Single term translation |
| POST | /api/v1/filter |
Match glossary terms in source content |
| GET | /api/v1/languages |
Supported languages with stats |
| GET | /api/v1/schema |
Glossary JSON schema |
| GET | /api/v1/info |
API metadata |
Term lookups resolve aliases, avoid forms, and variants to canonical entries:
on-chain->onchain(via avoid list)ZKP->zero-knowledge proof(via alias)dapps->decentralized application (dapp)(via variant)
POST source text to /api/v1/filter and get back matching glossary terms with translations. Strips code blocks, inline code, and URLs before matching.
curl -X POST https://<host>/api/v1/filter \
-H "Content-Type: application/json" \
-d '{"content": "Staking requires 32 ETH to run a validator.", "language": "es"}'Arabic, Bengali, Czech, German, Spanish, French, Hindi, Indonesian, Italian, Japanese, Korean, Marathi, Polish, Portuguese (Brazil), Russian, Swahili, Tamil, Telugu, Turkish, Ukrainian, Urdu, Vietnamese, Chinese (Simplified), Chinese (Traditional)
pnpm install
pnpm devRuns locally at http://localhost:8787.
- Hono -- web framework
- @hono/zod-openapi -- OpenAPI from Zod schemas
- Scalar -- API docs UI
- Container image built on every push to
main(.github/workflows/docker.yml), run on Ethereum Foundation infrastructure