Fetch Transaction Feed

The Transaction Feed API provides a detailed feed of blockchain transactions, allowing users to customize their query based on wallet addresses, transaction limits, tokens, and other parameters across EVM-compatible chains and Solana.

Authentication

You need to include a 'X-API-KEY' header with every request:

headers = {
  'X-API-KEY': 'YOUR_API_KEY'
}

Endpoint

BASE_URL = "https://feed-api.cielo.finance/api/v1/feed"

Query Parameters

Wallet (string) - Filters the feed by a specific wallet.

?wallet=C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB,0x240df0da944c11428eb9f8ad197cc211fd8d82ef

Limit (Integer) - Restricts the number of transactions included in the response, with a maximum cap of 100.

?limit=2

List (Integer) - Filters transactions based on s specified list ID. Wallet list ID’s can be obtained via the Cielo Web App.

?list=integer

Chains (Array of Strings) - Filters transactions based on specified blockchain networks.

?chains=solana,ethereum

txTypes (Array of Strings) - Filters transactions based on the specified transaction type. Can only include one of the follow values.

?txTypes=bridge,lp,lending,nft_lending,nft_mint,nft_trade,nft_transfer,swap,transfer

Tokens (Array of Strings) - Filters transactions based on specified token addresses or symbols.

?tokens=LINK,5F5xpXC1Fvkc8YEYnsM5Y1nbLMGDTG5uctQKEUytenUB

minUSD (Integer) - Filters transaction based on a specified minimum USD value.

?minUSD=250

Basic Query

Returns an array of transactions for all the wallets you are monitoring. Monitored wallets can be configured through the Cielo web application.

async function fetch() {
  const response = await fetch(
    "https://feed-api.cielo.finance/api/v1/feed",
    {
      method: "GET",
      headers: {
        "X-API-KEY": "YOUR_API_KEY",
        accept: "application/json",
      },
    }
  );
  const data = await response.json();

Response

{
  "status": "ok",
  "data": {
    "items": [
         {
        "wallet": "0x6b67623ff56c10d9dcfc2152425f90285fc74ddd",
        "wallet_label": "whale1",
        "tx_hash": "0x9396bd0ade2e2b8b170dca8896a53cc0e39e25c3cfa8a97b5b08d6db6f9b12e4",
        "tx_type": "transfer",
        "chain": "base",
        "index": 0,
        "timestamp": 1711014761,
        "block": 12112707,
        "from": "0x7fa0a6d3797437f1159d46af64cb12635f87170f",
        "to": "0x6b67623ff56c10d9dcfc2152425f90285fc74ddd",
        "from_label": "0x7fa0...7170f",
        "to_label": "0x6b67...74ddd",
        "amount_usd": 4597.554,
        "contract_address": "0x0000000000000000000000000000000000000000",
        "name": "Ethereum",
        "symbol": "ETH",
        "token_price_usd": 3536.58,
        "type": "ETH"
      },
      {
        "wallet": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "wallet_label": "whale2",
        "tx_hash": "2EAKZidvKEYt31CGCsVE6T6oi9UbFhzVRWLiJ4Aym5n4sPyTnRGYpCcZC187tTTU4WVBedP3YeZbw3ai1KVMUV3t",
        "tx_type": "swap",
        "chain": "solana",
        "index": 0,
        "timestamp": 1711023444,
        "block": 255543529,
        "dex": "",
        "from": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "to": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "token0_address": "native",
        "token0_amount": 0.2,
        "token0_amount_usd": 38.015393965,
        "token0_price_usd": 190.076969825,
        "token0_name": "Solana",
        "token0_symbol": "SOL",
        "token1_address": "9Wj7ojNWPDwAAmi1AX8T5uyrCpjW5yLFF9QwRiugkVha",
        "token1_amount": 2157320.357845,
        "token1_amount_usd": 38.015393965,
        "token1_price_usd": 0.000017621580321512615,
        "token1_name": "Community Of Pepe",
        "token1_symbol": "$COPEPE",
        "first_interaction": true
      }
    ],
    "paging": {
      "total_rows_in_page": 1,
      "has_next_page": true,
      "next_object_id": "NjVmYzAzOWQ4MDlkZDE4ZDMwZDM2NjljXzE3MTEwMTQ3NjE"
    }
  }
}

Wallet Filter Query

Returns an array of transactions filtered by the specified wallet address.

async function fetch(walletAddress) {
  const response = await fetch(
    `https://feed-api.cielo.finance/api/v1/feed?wallet=${walletAddress}`,
    {
      method: "GET",
      headers: {
        "X-API-KEY": "YOUR_API_KEY",
        accept: "application/json",
      },
    }
  );
  const data = await response.json();

{
  "status": "ok",
  "data": {
    "items": [
      {
        "wallet": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "wallet_label": "whale2",
        "tx_hash": "2EAKZidvKEYt31CGCsVE6T6oi9UbFhzVRWLiJ4Aym5n4sPyTnRGYpCcZC187tTTU4WVBedP3YeZbw3ai1KVMUV3t",
        "tx_type": "swap",
        "chain": "solana",
        "index": 0,
        "timestamp": 1711023444,
        "block": 255543529,
        "dex": "",
        "from": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "to": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "token0_address": "native",
        "token0_amount": 0.2,
        "token0_amount_usd": 38.015393965,
        "token0_price_usd": 190.076969825,
        "token0_name": "Solana",
        "token0_symbol": "SOL",
        "token1_address": "9Wj7ojNWPDwAAmi1AX8T5uyrCpjW5yLFF9QwRiugkVha",
        "token1_amount": 2157320.357845,
        "token1_amount_usd": 38.015393965,
        "token1_price_usd": 0.000017621580321512615,
        "token1_name": "Community Of Pepe",
        "token1_symbol": "$COPEPE",
        "first_interaction": true
      },
        {
        "wallet": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "wallet_label": "whale2",
        "tx_hash": "wLY7FPxsK5pCfFKgo3968hdTx6i897ucPkVc37MWJDCa13xmQ4QSuECkG7mDUpkV2L7A54fJ7WVUW9XyRAua6da",
        "tx_type": "swap",
        "chain": "solana",
        "index": 0,
        "timestamp": 1711023309,
        "block": 255543207,
        "dex": "",
        "from": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "to": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "token0_address": "native",
        "token0_amount": 1,
        "token0_amount_usd": 189.902147753,
        "token0_price_usd": 189.902147753,
        "token0_name": "Solana",
        "token0_symbol": "SOL",
        "token1_address": "GLvTUvnL2DqNnh7hKf1EyEZFEQ6JHw7wRhNfgMohAjKz",
        "token1_amount": 184860.851496,
        "token1_amount_usd": 189.902147753,
        "token1_price_usd": 0.0010272707618525121,
        "token1_name": "Smol",
        "token1_symbol": "SMOL",
        "first_interaction": true
      }
    ],
    "paging": {
      "total_rows_in_page": 1,
      "has_next_page": true,
      "next_object_id": "NjVmYzAzOWQ4MDlkZDE4ZDMwZDM2NjljXzE3MTEwMTQ3NjE"
    }
  }
}

Wallet & Chain Filter Query

Returns an array of transactions filtered by the specified wallet address and chain.

async function fetch(walletAddress, chain) {
  const response = await fetch(
    `https://feed-api.cielo.finance/api/v1/feed?wallet=${walletAddress}&chains=${chain}`,
    {
      method: "GET",
      headers: {
        "X-API-KEY": "YOUR_API_KEY",
        accept: "application/json",
      },
    }
  );
  const data = await response.json();

Response

{
  "status": "ok",
  "data": {
    "items": [
      {
        "wallet": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "wallet_label": "whale2",
        "tx_hash": "2EAKZidvKEYt31CGCsVE6T6oi9UbFhzVRWLiJ4Aym5n4sPyTnRGYpCcZC187tTTU4WVBedP3YeZbw3ai1KVMUV3t",
        "tx_type": "swap",
        "chain": "solana",
        "index": 0,
        "timestamp": 1711023444,
        "block": 255543529,
        "dex": "",
        "from": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "to": "C6y7QWSmm14PDka3bW5Lg7CNUSEFNC9JvDmSFZuMkqBB",
        "token0_address": "native",
        "token0_amount": 0.2,
        "token0_amount_usd": 38.015393965,
        "token0_price_usd": 190.076969825,
        "token0_name": "Solana",
        "token0_symbol": "SOL",
        "token1_address": "9Wj7ojNWPDwAAmi1AX8T5uyrCpjW5yLFF9QwRiugkVha",
        "token1_amount": 2157320.357845,
        "token1_amount_usd": 38.015393965,
        "token1_price_usd": 0.000017621580321512615,
        "token1_name": "Community Of Pepe",
        "token1_symbol": "$COPEPE",
        "first_interaction": true
      },
        {
        "wallet": "6sdb5o3XWM27RSjcYqoVZ88ruuPzHTfqFQEq26nN6eVq",
        "wallet_label": "whale3",
        "tx_hash": "4r3R5k4XNLhct3o2jLaYwjKRcohmV6jHSd3FipJ4cDDvFB5BwrXq4pVxKGktUNMTmiTFzSu79U2cpp1CjVruFufG",
        "tx_type": "swap",
        "chain": "solana",
        "index": 0,
        "timestamp": 1711005068,
        "block": 255499560,
        "dex": "",
        "from": "6sdb5o3XWM27RSjcYqoVZ88ruuPzHTfqFQEq26nN6eVq",
        "to": "6sdb5o3XWM27RSjcYqoVZ88ruuPzHTfqFQEq26nN6eVq",
        "token0_address": "9Ttyez3xiruyj6cqaR495hbBkJU6SUWdV6AmQ9MvbyyS",
        "token0_amount": 111237179.719028,
        "token0_amount_usd": 52561.70051676631,
        "token0_price_usd": 0.00047251917613814885,
        "token0_name": "smolecoin",
        "token0_symbol": "smole",
        "token1_address": "native",
        "token1_amount": 276.577156721,
        "token1_amount_usd": 52561.70051676631,
        "token1_price_usd": 190.043534831,
        "token1_name": "Solana",
        "token1_symbol": "SOL",
        "first_interaction": false
      }
    ],
    "paging": {
      "total_rows_in_page": 1,
      "has_next_page": true,
      "next_object_id": "NjVmYzAzOWQ4MDlkZDE4ZDMwZDM2NjljXzE3MTEwMTQ3NjE"
    }
  }
}

Swap and Token Query

Returns an array of swap transactions filtered by the specified token address.

async function fetch(tokenAddress) {
  const response = await fetch(
    `https://feed-api.cielo.finance/api/v1/feed?txTypes=swap&tokens=${tokenAddress}`,
    {
      method: "GET",
      headers: {
        "X-API-KEY": "YOUR_API_KEY",
        accept: "application/json",
      },
    }
  );
  const data = await response.json();

Response

{
  "status": "ok",
  "data": {
    "items": [
        {
        "wallet": "6sdb5o3XWM27RSjcYqoVZ88ruuPzHTfqFQEq26nN6eVq",
        "wallet_label": "whale3",
        "tx_hash": "4r3R5k4XNLhct3o2jLaYwjKRcohmV6jHSd3FipJ4cDDvFB5BwrXq4pVxKGktUNMTmiTFzSu79U2cpp1CjVruFufG",
        "tx_type": "swap",
        "chain": "solana",
        "index": 0,
        "timestamp": 1711005068,
        "block": 255499560,
        "dex": "",
        "from": "6sdb5o3XWM27RSjcYqoVZ88ruuPzHTfqFQEq26nN6eVq",
        "to": "6sdb5o3XWM27RSjcYqoVZ88ruuPzHTfqFQEq26nN6eVq",
        "token0_address": "9Ttyez3xiruyj6cqaR495hbBkJU6SUWdV6AmQ9MvbyyS",
        "token0_amount": 111237179.719028,
        "token0_amount_usd": 52561.70051676631,
        "token0_price_usd": 0.00047251917613814885,
        "token0_name": "smolecoin",
        "token0_symbol": "smole",
        "token1_address": "native",
        "token1_amount": 276.577156721,
        "token1_amount_usd": 52561.70051676631,
        "token1_price_usd": 190.043534831,
        "token1_name": "Solana",
        "token1_symbol": "SOL",
        "first_interaction": false
      }
    ],
    "paging": {
      "total_rows_in_page": 1,
      "has_next_page": true,
      "next_object_id": "NjVmYzAzOWQ4MDlkZDE4ZDMwZDM2NjljXzE3MTEwMTQ3NjE"
    }
  }
}