# Zerion API - Chain Details Lookup

> Zerion API - Chain Details Lookup is a paid API for AI agents from api.zerion.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-14).

Retrieves metadata and details for a specific blockchain chain by chain ID from Zerion's multi-chain index

## Facts

- Endpoint: GET https://api.zerion.io/v1/chains/%7Bchain_id%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zerion-api-chain-details-lookup-4de77d11
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vn4yRqd5Zu0R9h_1bY_zG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zerion-api-chain-details-lookup-4de77d11
```

Example prompt: Can you pull up the chain details for Ethereum mainnet from Zerion — I need the chain metadata like its ID and attributes?

## When to prefer this

Use this endpoint when you need to verify or retrieve metadata for a specific blockchain network by its chain identifier within the Zerion ecosystem. Prefer this over generic chain registries when you are already using Zerion for wallet data, DeFi positions, or portfolio lookups, as it ensures chain IDs are consistent with the rest of the Zerion API. It is especially useful for validating chain support before making downstream wallet or transaction queries.

## Known failure modes

- Invalid or unsupported chain_id returns a 404 or empty data response
- Chain ID string mismatch (e.g. wrong slug format) causes lookup failure
- x402 payment failure if USDC balance is insufficient or payment header is malformed
- Rate limiting if too many calls are made without proper payment
- Network timeout if Zerion API is temporarily unavailable

## How this service works

Interpreted wallet data for more than 40 chains and Solana: portfolios, DeFi positions, PnL, transactions and NFTs. REST for apps, x402 pay-per-call for agents.

## Output

A JSON object containing a `data` field with the chain resource including its `id`, `type`, and `attributes` object with chain-specific metadata (name, explorer URLs, etc.), plus a `links` object with a self-referential URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain_id"
     ],
     "properties": {
      "chain_id": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data"
     ],
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "id": {
         "type": "string",
         "description": "Resource ID."
        },
        "type": {
         "type": "string",
         "description": "Resource type."
        },
        "attributes": {
         "type": "object",
         "description": "Resource attributes; see https://developers.zerion.io"
        }
       }
      },
      "links": {
       "type": "object",
       "description": "Self and pagination links."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "<resource id>",
   "type": "<resource type>",
   "attributes": {}
  },
  "links": {
   "self": "https://api.zerion.io/v1/..."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zerion-api-chain-details-lookup-4de77d11/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zerion.io](https://www.zero.xyz/host/api.zerion.io/llms.txt)
