> For the complete documentation index, see [llms.txt](https://docs.yifi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yifi.io/api-reference/chains.md).

# Chains

Supported blockchain networks (`GET /v1/chains`)

## List supported chains

> All cached networks, sorted by popularity then name. \`id\` is the canonical \*\*slug\*\* used as \`network\` / \`networkFrom\` / \`fromNetwork\` on other endpoints. \`aliases\` are etalon names (not accepted as \`GET /v1/tokens?network=\`). Empty cache → \`{ chains: \[] }\`. No query parameters.

```json
{"openapi":"3.0.0","info":{"title":"YiFi Swap Public API","version":"1.0"},"tags":[{"name":"Chains","description":"Supported blockchain networks (`GET /v1/chains`)"}],"servers":[{"url":"https://api.yifi.io","description":"Production"},{"url":"https://api-dev.yifi.io","description":"Development / Staging"}],"paths":{"/v1/chains":{"get":{"description":"All cached networks, sorted by popularity then name. `id` is the canonical **slug** used as `network` / `networkFrom` / `fromNetwork` on other endpoints. `aliases` are etalon names (not accepted as `GET /v1/tokens?network=`). Empty cache → `{ chains: [] }`. No query parameters.","operationId":"getChains","parameters":[],"responses":{"200":{"description":"List of supported chains","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainsListApiResponseDto"}}}},"500":{"description":"Failed to fetch chains","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable code (`COIN_NOT_FOUND`, `RATE_EXPIRED`, `INVALID_API_KEY`, `HTTP_EXCEPTION` for class-validator, …)"},"message":{"description":"Human-readable message. Class-validator 400s may return a string **array** of constraint texts.","oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"requestId":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"details":{"description":"Present for some validation (4xx) errors when thrown with `details`.","oneOf":[{"type":"object","additionalProperties":true},{"type":"array"}]}},"required":["code","message","requestId","timestamp"]}}}}}}},"summary":"List supported chains","tags":["App","Chains"]}}},"components":{"schemas":{"ChainsListApiResponseDto":{"type":"object","properties":{"chains":{"type":"array","items":{"$ref":"#/components/schemas/ChainItemApiDto"}}},"required":["chains"]},"ChainItemApiDto":{"type":"object","properties":{"id":{"type":"string","description":"Canonical slug. Use this value as `network`, `networkFrom`, `fromNetwork`, etc."},"name":{"type":"string","description":"Human-readable network name"},"chainId":{"type":"number","nullable":true},"status":{"type":"string","enum":["active","inactive","maintenance"]},"supportedEngines":{"type":"array","items":{"type":"string"}},"aliases":{"type":"array","items":{"type":"string"}},"nativeToken":{"type":"string"},"blockTime":{"type":"string","nullable":true},"providers":{"type":"object","description":"Liquidity provider slugs keyed by engine category","additionalProperties":true},"explorerUrl":{"type":"string"},"logoUrl":{"type":"object","nullable":true},"memoNeeded":{"type":"boolean","description":"Whether transfers on this chain require a memo/tag (derived from active coins with extraId)."}},"required":["id","name","chainId","status","supportedEngines","aliases","nativeToken"]}}}}
```