CCIP API Documentation v1

The Cross-Chain Interoperability Protocol (CCIP) API provides comprehensive information about supported blockchain networks, tokens, and their configurations.

API Overview

This documentation provides details about:

  • Available endpoints for retrieving chain and token information
  • Chain details including IDs, selectors, and contract addresses
  • Token details including supported chains and transfer lanes
  • Supported fee tokens for cross-chain operations
  • Error handling and response formats

Use the interactive documentation below to explore and test the API endpoints.

Last Updated: March 6, 2025

API Usage Examples

Example: Fetch All Mainnet Chains

curl -X GET "https://docs.chain.link/api/ccip/v1/chains?environment=mainnet" \
  -H "accept: application/json"

Example: Filter by Chain IDs

curl -X GET "https://docs.chain.link/api/ccip/v1/chains?environment=mainnet&chainId=1,137" \
  -H "accept: application/json"

Example: JavaScript API Request

// Example 1: Fetch CCIP Chains
const fetchCcipChains = async () => {
  try {
    const response = await fetch(
      'https://docs.chain.link/api/ccip/v1/chains?environment=mainnet&chain_id=1'
    );
    const data = await response.json();
    console.log('Chain data:', data);
    return data;
  } catch (err) {
    console.error('Error fetching CCIP chains:', err);
  }
}

// Example 2: Fetch CCIP Tokens
const fetchCcipTokens = async () => {
  try {
    const response = await fetch(
      'https://docs.chain.link/api/ccip/v1/tokens?environment=mainnet&token_id=LINK'
    );
    const data = await response.json();
    console.log('Token data:', data);
    return data;
  } catch (err) {
    console.error('Error fetching CCIP tokens:', err);
  }
}