📡API Endpoints

API Status

This endpoint retrieves the API endpoint status.

API Status

GEThttps://api.chainlyze.ceylabs.io/v2/p/ping

Header parameters

Response

200

Successful response

Body

application/json

msgstring

Example: "Welcome to Chainlyze API V2"

Request

JavaScriptCurlPython

const response = await fetch('https://api.chainlyze.ceylabs.io/v2/p/ping', {
    method: 'GET',
    headers: {
      "x-api-key": "your-api-key"
    },
});
const data = await response.json();

Response

200

{
  "msg": "Welcome to Chainlyze API V2"
}

---

Supported Chains

This endpoint retrieves the list of supported crypto networks.

List chains

GEThttps://api.chainlyze.ceylabs.io/v2/p/chain/list

Header parameters

Response

200

Successful response with list of chains

Body

application/json

idstring

Example: "30000000-0000-0000-0000-000000000001"

namestring

Example: "Ethereum"

short_namestring

Example: "ETH"

native_tokenstring

Example: "ethereum"

evm_chain_idinteger

Example: 1

is_testnetboolean

Example: false

is_supportedboolean

Example: true

coingecko_idstring

Example: "ethereum"

explorerstring

Example: "https://etherscan.io"

Request

JavaScriptCurlPython

const response = await fetch('https://api.chainlyze.ceylabs.io/v2/p/chain/list', {
    method: 'GET',
    headers: {
      "x-api-key": "your-api-key"
    },
});
const data = await response.json();

Response

200

[
  {
    "id": "30000000-0000-0000-0000-000000000001",
    "name": "Ethereum",
    "short_name": "ETH",
    "native_token": "ethereum",
    "evm_chain_id": 1,
    "is_testnet": false,
    "is_supported": true,
    "coingecko_id": "ethereum",
    "explorer": "https://etherscan.io"
  }
]

---

Token Balances

This endpoint retrieves the wallet token balances

Get wallet balances

GEThttps://api.chainlyze.ceylabs.io/v2/p/balance/token/list

Query parameters

Header parameters

Response

200

Successful response with wallet balances

Body

application/json

namestring

Example: "Chainlink"

symbolstring

Example: "LINK"

balancestring

Example: "10.00000000"

pricenumber (float)

Example: 7.5

iconstring

Example: "https://cdn.chainlyze.io/logos/chainlink-link-logo.png"

chain_idstring

Example: "ethereum"

changesobject

Request

JavaScriptCurlPython

const response = await fetch('https://api.chainlyze.ceylabs.io/v2/p/balance/token/list?address=0x1234567890abcdef1234567890abcdef12345678', {
    method: 'GET',
    headers: {
      "x-api-key": "your-api-key"
    },
});
const data = await response.json();

Response

200

[
  {
    "name": "Chainlink",
    "symbol": "LINK",
    "balance": "10.00000000",
    "price": 7.5,
    "icon": "https://cdn.chainlyze.io/logos/chainlink-link-logo.png",
    "chain_id": "ethereum",
    "changes": {
      "absolute": 0.5,
      "percent": 7.15
    }
  }
]

---

DeFi Portfolio Positions

This endpoint retrieves the DeFi position of a specific wallet

Get position balances

GEThttps://api.chainlyze.ceylabs.io/v2/p/balance/defi-position/list

Query parameters

Header parameters

Response

200

Successful response with position balances

Body

application/json

protocolstring

Example: "Uniswap V3"

namestring

Example: "Uniswap V3 ETH/WETH Pool"

position_typestring

Example: "deposit"

amountstring

Example: "0.12345"

pricenumber (float)

Example: 3355.123

iconstring

Example: "https://cdn.chainlyze.io/0x1234567890abcdef1234567890abcdef12345678.png"

chain_idstring

Example: "ethereum"

Request

JavaScriptCurlPython

const response = await fetch('https://api.chainlyze.ceylabs.io/v2/p/balance/defi-position/list?address=0x1234567890abcdef1234567890abcdef12345678', {
    method: 'GET',
    headers: {
      "x-api-key": "your-api-key"
    },
});
const data = await response.json();

Response

200

[
  {
    "protocol": "Uniswap V3",
    "name": "Uniswap V3 ETH/WETH Pool",
    "position_type": "deposit",
    "amount": "0.12345",
    "price": 3355.123,
    "icon": "https://cdn.chainlyze.io/0x1234567890abcdef1234567890abcdef12345678.png",
    "chain_id": "ethereum"
  }
]

---

Wallet Transactions

This endpoints retrieves the transaction history of a specific wallet

List transactions

GEThttps://api.chainlyze.ceylabs.io/v2/p/transaction/list

Query parameters

Header parameters

Response

200

Successful response with transaction data

Body

application/json

cursorobject

transactionsarray of Transaction (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.chainlyze.ceylabs.io/v2/p/transaction/list?address=0x1234567890abcdef1234567890abcdef12345678', {
    method: 'GET',
    headers: {
      "x-api-key": "your-api-key"
    },
});
const data = await response.json();

Response

200

{
  "cursor": {
    "hash": "0xb1c2d3e4f5678901abcdef2345678901abcdef2345678901abcdef2345678901b",
    "limit": 10
  },
  "transactions": [
    {
      "timestamp": "2024-07-31T13:01:27Z",
      "txId": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef1234567890abcdef1234567890a",
      "chain": "ethereum",
      "method": "receive",
      "trash": false,
      "from": "0x1234567890abcdef1234567890abcdef12345678",
      "to": "0xabcdef1234567890abcdef1234567890abcdef12",
      "transfers": [
        {
          "quantity": "1000000.00000000",
          "direction": "in",
          "symbol": "USDT",
          "price": 1,
          "type": "ERC20",
          "contract_address": "0xabcdef1234567890abcdef1234567890abcdef12"
        }
      ]
    }
  ]
}