# Get list of supported blockchains

Returns a list of blockchains that are actively supported for monitoring and balance queries.

These are the blockchains where the system can track address balances, detect transactions, and send
notifications about balance changes. While tokens can be sent on many blockchains, only those listed
here have the infrastructure to monitor addresses and provide real-time updates.

Endpoint: GET /blockchains
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `limit` (integer)
    Maximum number of items to return
    Example: 20

  - `page` (integer)
    Page number for pagination
    Example: 1

  - `sort_by` (string)
    Field to sort results by. Use "-" prefix for descending order
    Enum: "gid", "-gid", "name", "-name", "short_name", "-short_name", "full_name", "-full_name"

  - `search` (string)
    Performs a partial, case-insensitive match on blockchain name or short name fields.
    Example: "ethereum"

  - `families` (array)
    Comma-separated list of chain families to include.
    Enum: "evm", "bitcoin", "solana", "tron"

  - `is_active` (boolean)
    When true, returns only active blockchains (being processed by workers). When false, returns only inactive ones.
    Example: true

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.gid` (string, required)
    Blockchain identifier according to [CAIP-2](https://chainagnostic.org/CAIPs/caip-2).

The chain_gid is a case-sensitive string uniquely identifying a blockchain.
It is composed of:
- namespace — a short identifier describing an ecosystem or standard (e.g. eip155, cosmos)
- reference — an identifier for a specific blockchain within that namespace

Syntax

chain_id = namespace ":" reference
namespace = [-a-z0-9]{3,8}
reference = [-_a-zA-Z0-9]{1,32}


Examples
- eip155:1 — Ethereum mainnet
- eip155:56 — Binance Smart Chain
- cosmos:cosmoshub-4 — Cosmos Hub mainnet
- bip122:000000000019d6689c085ae165831e93 — Bitcoin mainnet
    Example: "eip155:1"

  - `items.image_url` (string, required)
    URL to blockchain logo image
    Example: "https://cdn.vilna.io/assets/eip155:1/logo.png"

  - `items.name` (string, required)
    Unique identifier name for the blockchain (e.g., ethereum)
    Example: "ethereum"

  - `items.short_name` (string, required)
    Short abbreviation for the blockchain (e.g., eth)
    Example: "eth"

  - `items.is_active` (boolean, required)
    Whether the blockchain is actively being processed
    Example: true

  - `meta` (object, required)

  - `meta.limit` (integer, required)
    Number of items per page
    Example: 20

  - `meta.page` (integer, required)
    Current page number
    Example: 1

  - `meta.total` (integer, required)
    Total number of items available
    Example: 42

  - `meta.total_pages` (integer, required)
    Total number of pages available
    Example: 3

## Response 400 fields (application/problem+json):

  - `type` (string, required)
    A URI reference that identifies the problem type
    Example: "https://docs.vilna.io/apis/problems/invalid-request"

  - `title` (string, required)
    A short, human-readable summary of the problem type
    Example: "Invalid Request"

  - `status` (integer, required)
    The HTTP status code
    Example: 400

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem
    Example: "Validation error"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem
    Example: "/errors?id=XXXXXX-xxxxx"

  - `fields` (array)
    List of invalid fields in the request

  - `fields.name` (string, required)
    The name of the invalid field
    Example: "meta"

  - `fields.reason` (string, required)
    Why this field is invalid
    Example: "Exceeded maximum data size — must not exceed 1000 characters"

## Response default fields (application/problem+json):

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem
    Example: "An unexpected error occurred while processing your request"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem
    Example: "/errors/1234567890"

  - `status` (integer, required)
    The HTTP status code
    Example: 500

  - `title` (string, required)
    A short, human-readable summary of the problem type
    Example: "Internal Server Error"

  - `type` (string, required)
    A URI reference that identifies the problem type
    Example: "https://api.vilna.io/problems/internal-error"