Docs
Public APIs for wallets and integrators
Read the live Ethics launch registry without an API key. Use this for token lists, discovery, and indexing. Site-only routes that require an Ethics origin are not for third-party apps.
- Token list
- Public
- Per IP
- 60/min
- CDN cache
- ~60s
- Launch API
- Soon
Live
Token list API
Returns public Solana and EVM launches from the Ethics registry. New tokens appear after register (typically within 1–2 minutes with caches). Hidden smoke launches stay filtered out.
Endpoint
GET https://ethics.ltd/api/token-list
| Contract | |
|---|---|
| Auth | None — public read |
| CORS | Access-Control-Allow-Origin: * |
| Rate limit | 60 requests / IP / minute → 429 + Retry-After |
| Cache | ~60s at CDN (s-maxage=60). Poll every 30–60s. |
Query
Optional ?chain= filter:
| chain | Returns |
|---|---|
| (omit) | Full payload — Solana + all EVM chains |
| solana | Solana launches only |
| 56 or bnb | BNB (chainId 56) only |
| 8453 or base | Base (chainId 8453) only |
| 4663 or robinhood | Robinhood (chainId 4663) only |
| 999 or hyperevm | HyperEVM (chainId 999) only |
| 42161 or arbitrum | Arbitrum (chainId 42161) only |
| 5042 or arc | Arc (chainId 5042) only |
Response shape
{
"updatedAt": "<ISO>",
"solana": { "launches": [ /* RegisteredLaunch */ ] },
"evm": {
"56": { "chainId": 56, "label": "BNB", "launches": [ … ] },
"8453": { "chainId": 8453, "label": "Base", "launches": [ … ] },
"4663": { "chainId": 4663, "label": "Robinhood", "launches": [ … ] },
"999": { "chainId": 999, "label": "HyperEVM", "launches": [ … ] },
"42161": { "chainId": 42161, "label": "Arbitrum", "launches": [ … ] }
}
}EVM keys are always present (empty launches arrays when none). Each Solana / EVM row includes name, symbol, icon, pool, and create metadata from the registry.
| Key | Network |
|---|---|
| 56 | BNB |
| 8453 | Base |
| 4663 | Robinhood |
| 999 | HyperEVM |
| 42161 | Arbitrum |
| 5042 | Arc |
Examples
curl -sS 'https://ethics.ltd/api/token-list' curl -sS 'https://ethics.ltd/api/token-list?chain=solana' curl -sS 'https://ethics.ltd/api/token-list?chain=56'
What partners should know
Prefer /api/token-list for wallets and backends. /api/launches and /api/evm/launches are Origin-gated for the ethics.ltd UI and will reject bare curl or third-party origins.
Planned
Coming soonLaunch API
A public Launch API for partners and wallets to create and track Ethics Solana and EVM launches programmatically. Not available yet — do not call undocumented write or register routes from third-party apps.
| Area | Intent |
|---|---|
| Create launch | Programmatic Solana / EVM create + register for partners |
| Launch status | Lookup by mint, token address, or tx hash |
| Auth | Partner credentials — model TBD |
What partners should know
Until the Launch API ships, create tokens through ethics.ltd (or your existing partner flow). Watch this docs page for endpoint URLs, auth, and rate limits when they go live.