---
title: "List supported chains and tokens"
method: GET
path: "/chains"
tags: ["catalog"]
---

# List supported chains and tokens

`GET /chains`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hevn-inc/apis/hevn-api/docs/chains/get.ts> (a function with typed inputs; its response is checked against the schema)

Every chain and token this API names, with the contract address and decimals of each token. `settlement` marks the chain accounts hold their balance on and the tokens a payout can be funded with.

## Response `200`

Successful Response

- ChainListView
  - `chains` ChainView[], required: Every chain this API names, settlement chain included.
    - `chain` string, required: Chain code used by contacts, payouts and transactions.
    - `name` string, required: Human-readable chain name.
    - `chainId` integer, nullable: EVM chain id; absent for non-EVM chains.
    - `settlement` boolean, required: Whether payouts, payins and swaps settle on this chain. A token elsewhere may still name an account.
    - `tokens` TokenView[], required: Tokens this API names on the chain.
      - `symbol` string, required: Token symbol, as contacts and payouts name it.
      - `decimals` integer, required: On-chain decimals of the token's smallest unit.
      - `address` string, nullable: ERC-20 contract address; absent for a chain's gas coin.
      - `native` boolean, required: Whether this is the chain's gas coin.
      - `account` 'USDC' | 'EURC' | 'RD' | 'USDC_ARB' | 'FDIC_USD' | 'FDIC_EUR' | 'KYC_CARDS'

## Other responses

- `422`: Request validation failed

## Changes

- **2026-11-12** `299a3aa6f521`: 2 warning, 2 info
  - added the new `FDIC_EUR` enum value to the `chains/items/tokens/items/account/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - added the new `verification_not_applicable` enum value to the `error/code` response property for the response status `422`
  - removed the `phone_required` enum value from the `error/code` response property for the response status `422`
  - removed the `rail_requirements_unmet` enum value from the `error/code` response property for the response status `422`
- **2026-10-23** `a02795de2d2b`: 12 warning, 5 info
  - deleted the `header` request parameter `x-api-key`
  - added the new `KYC_CARDS` enum value to the `chains/items/tokens/items/account/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - added the new `RD` enum value to the `chains/items/tokens/items/account/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - added the new `USDC_ARB` enum value to the `chains/items/tokens/items/account/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - …13 more
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `phone_in_use` enum value from the `error/code` response property for the response status `422`
- **2026-10-20** `bd6c9d69540e`: 1 warning
  - added the new `phone_in_use` enum value to the `error/code` response property for the response status `422`
- …earlier changes not shown

[Operation history](https://skmtc.dev/hevn-inc/apis/hevn-api/changes/chains/get.md)

---

[API](https://skmtc.dev/hevn-inc/apis/hevn-api.md) - [All operations](https://skmtc.dev/hevn-inc/apis/hevn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hevn-inc/apis/hevn-api/revisions/299a3aa6f521?raw)