Chains

Retrieve a list of all blockchain networks supported by Octav, including chain metadata, icons, and explorer URLs. Results are sorted alphabetically by name.

Cost: Free (0 credits)

Interactive Playground: Test this endpoint in the API Playground. Get your API key at data.octav.fi

Tip: Use this endpoint to discover valid chainKey values for other endpoints like Protocols. The chain list is cached for 24 hours — newly added chains may take up to 24h to appear.

Endpoint

GET https://api.octav.fi/v1/chains

No parameters required.

Response

Returns an array of supported chain objects.

Chain Fields

chainId

string

Blockchain network ID (e.g. "1" for Ethereum mainnet)

key

string

Short identifier used in API requests (e.g. "ethereum", "solana", "arbitrum")

name

string

Human-readable chain name (e.g. "Ethereum", "Solana")

symbol

string

Native token symbol (e.g. "ETH", "SOL")

color

string

Hex color code for UI display (e.g. "#627EEA")

imgSmall

string

URL to small chain icon

imgLarge

string

URL to large chain icon

explorerTokenUrl

string

Block explorer URL template for tokens

explorerTransactionUrl

string

Block explorer URL template for transactions

explorerAddressUrl

string

Block explorer URL template for addresses

blockscoutExplorerAddressUrl

string | null

Blockscout explorer URL for addresses (null if unavailable)

blockscoutExplorerTokenUrl

string | null

Blockscout explorer URL for tokens (null if unavailable)

blockscoutExplorerTransactionUrl

string | null

Blockscout explorer URL for transactions (null if unavailable)

isPortfolioSupported

boolean

Whether portfolio tracking is supported on this chain

isTransactionsSupported

boolean

Whether transaction history is supported on this chain

Example Request

curl "https://api.octav.fi/v1/chains" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://api.octav.fi/v1/chains', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const chains = await response.json();
console.log(`Supported chains: ${chains.length}`);

import requests

response = requests.get(
    'https://api.octav.fi/v1/chains',
    headers={'Authorization': f'Bearer {api_key}'}
)

chains = response.json()
print(f'Supported chains: {len(chains)}')

interface Chain {
  chainId: string;
  key: string;
  name: string;
  symbol: string;
  color: string;
  imgSmall: string;
  imgLarge: string;
  explorerTokenUrl: string;
  explorerTransactionUrl: string;
  explorerAddressUrl: string;
  blockscoutExplorerAddressUrl: string | null;
  blockscoutExplorerTokenUrl: string | null;
  blockscoutExplorerTransactionUrl: string | null;
  isPortfolioSupported: boolean;
  isTransactionsSupported: boolean;
}

const response = await fetch('https://api.octav.fi/v1/chains', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const chains: Chain[] = await response.json();
console.log(`Supported chains: ${chains.length}`);

Example Response

View Full Response

[
  {
    "chainId": "1",
    "key": "ethereum",
    "name": "Ethereum",
    "symbol": "ETH",
    "color": "#627EEA",
    "imgSmall": "https://images.octav.fi/chains/ethereum_icon.svg",
    "imgLarge": "https://images.octav.fi/chains/ethereum_icon.svg",
    "explorerTokenUrl": "https://etherscan.io/token/",
    "explorerTransactionUrl": "https://etherscan.io/tx/",
    "explorerAddressUrl": "https://etherscan.io/address/",
    "blockscoutExplorerAddressUrl": null,
    "blockscoutExplorerTokenUrl": null,
    "blockscoutExplorerTransactionUrl": null,
    "isPortfolioSupported": true,
    "isTransactionsSupported": true
  },
  {
    "chainId": "42161",
    "key": "arbitrum",
    "name": "Arbitrum",
    "symbol": "ETH",
    "color": "#28A0F0",
    "imgSmall": "https://images.octav.fi/chains/arbitrum_icon.svg",
    "imgLarge": "https://images.octav.fi/chains/arbitrum_icon.svg",
    "explorerTokenUrl": "https://arbiscan.io/token/",
    "explorerTransactionUrl": "https://arbiscan.io/tx/",
    "explorerAddressUrl": "https://arbiscan.io/address/",
    "blockscoutExplorerAddressUrl": null,
    "blockscoutExplorerTokenUrl": null,
    "blockscoutExplorerTransactionUrl": null,
    "isPortfolioSupported": true,
    "isTransactionsSupported": true
  }
]

Use Cases

Build Chain Selector
Discover Chain Keys
Explorer Links

Populate a chain dropdown in your UI:

const response = await fetch('https://api.octav.fi/v1/chains', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

const chains = await response.json();

// Filter to chains with portfolio support
const portfolioChains = chains.filter(c => c.isPortfolioSupported);

// Build selector options
const options = portfolioChains.map(chain => ({
  value: chain.key,
  label: chain.name,
  icon: chain.imgSmall,
  color: chain.color
}));

Look up valid chain keys for use with other endpoints:

const response = await fetch('https://api.octav.fi/v1/chains', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

const chains = await response.json();

// Get all valid chain keys
const chainKeys = chains.map(c => c.key);
console.log('Valid chain keys:', chainKeys.join(', '));

// Check if a chain key is valid before querying protocols
function isValidChain(key) {
  return chainKeys.includes(key);
}

Generate block explorer links for addresses and transactions:

const response = await fetch('https://api.octav.fi/v1/chains', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

const chains = await response.json();
const chainMap = Object.fromEntries(chains.map(c => [c.key, c]));

function getExplorerUrl(chainKey, type, hash) {
  const chain = chainMap[chainKey];
  if (!chain) return null;

  switch (type) {
    case 'address': return chain.explorerAddressUrl + hash;
    case 'tx': return chain.explorerTransactionUrl + hash;
    case 'token': return chain.explorerTokenUrl + hash;
  }
}

// Example
const url = getExplorerUrl('ethereum', 'address', '0x6426af...');
// => "https://etherscan.io/address/0x6426af..."

Error Responses

401 Unauthorized

Authentication failed.

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

Solution: Check your API key in the Authorization header

429 Too Many Requests

Rate limit exceeded.

{
  "error": "Rate limit exceeded",
  "message": "You have exceeded your rate limit",
  "retry_after": 60
}

Solution: Wait for the specified time or implement retry logic

Protocols

List DeFi protocols available on a chain

Portfolio

Get portfolio holdings across chains

Supported Chains Reference

Full chain support matrix

Transactions

Query transaction history by chain

Getting Started

Endpoints

Playground

AI Development

Migrate to Octav

Reference

Endpoint

Response

Chain Fields

Example Request

Example Response

Use Cases

Error Responses

Protocols

Portfolio

Supported Chains Reference

Transactions

​Endpoint

​Response

​Chain Fields

​Example Request

​Example Response

​Use Cases

​Error Responses

​Related Endpoints

Protocols

Portfolio

Supported Chains Reference

Transactions

Endpoint

Response

Chain Fields

Example Request

Example Response

Use Cases

Error Responses

Related Endpoints