Trades - Token

API Endpoint: /defi/txs/token

Description: This endpoint returns transaction records of a specific token on any blockchains that Birdeye supports. It provides information about transactions related to the specified token, including trade details, ownership, source, and other relevant data.

Request Method: GET

Data Coverage: Multi-chain

Request URL:

https://public-api.birdeye.so/defi/txs/token?address=So11111111111111111111111111111111111111112&offset=0&limit=10

Request Headers:

accept: application/json
x-chain: any chains that Birdeye supports. Example: solana, ethereum
X-API-KEY: YOUR_API_KEY

Parameters:

Key	Data Type	Details	Example
`address`	string	The token address to retrieve transaction records for.	Required default: So11111111111111111111111111111111111111112
'sort_by'	string	Sort the response market data by selected criteria.	Required Value: {liquidity; volume24h} Default: liquidity
'sort_type'	string	Sort the response market data by descending or ascending order.	Required Value: {desc, asc} Default: desc
`offset`	integer	The starting index for the list of market	NOT required Default: 0
`limit`	integer	The maximum number of markets to retrieve.	NOT required Range: {1:10} Default: 10

Response: The response includes a list of transaction records, along with details such as trade information, ownership, source, and more.

Example Request:

curl -X 'GET' \
  --url 'https://dev-public-api.birdeye.so/defi/v2/markets?address=So11111111111111111111111111111111111111112&sort_by=liquidity&sort_type=desc&offset=10&limit=10' \
  -H 'accept: application/json' \
  -H 'x-chain: solana' \
  -H 'X-API-KEY: YOUR_API_KEY'

Example Response:

{
  "success": true,
  "data": {
    "markets": [
      {
        "address": "2zpHCabRwk4KiDVmz5Gh1pN5MHezwL8ccYLebjBryjY3",
        "base": {
          "address": "48EWerq7ztGdxxfMgVhz121hyW3yqrv3tVsamMvYfJKm",
          "decimals": 9,
          "symbol": "SMPEPE",
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fipfs.io%2Fipfs%2FQmZDxxC7ENLUCRQkk3eunFGuWwniEBLWuWmcJAadN2N8wo"
        },
        "bonfidaLock": null,
        "createdAt": "2024-04-24T22:46:46.459Z",
        "liquidity": 10994507.98510653,
        "lpBurn": {
          "lpMint": "HGArKppTLSU6ut59xbQWSgV1qCCQwus5gZvZke1X1HXD",
          "lpCurrentSupply": 0,
          "lpReserve": 1,
          "burnRatio": 100,
          "decimals": 9,
          "pairAddress": "2zpHCabRwk4KiDVmz5Gh1pN5MHezwL8ccYLebjBryjY3"
        },
        "name": "SMPEPE-SOL",
        "price": 0.00003635676,
        "quote": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "sollamaLock": null,
        "source": "raydium",
        "trade24h": 13,
        "trade24hChangePercent": 160,
        "uniqueWallet24h": 10,
        "uniqueWallet24hChangePercent": 150,
        "volume24h": null
      },
      {
        "address": "Lee1XZJfJ9Hm2K1qTyeCz1LXNc1YBZaKZszvNY4KCDw",
        "base": {
          "address": "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FmSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So%2Flogo.png",
          "symbol": "mSOL"
        },
        "createdAt": "2022-03-11T07:53:05.281Z",
        "name": "mSOL-SOL",
        "quote": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "source": "saber",
        "liquidity": 8806231.311671562,
        "price": 1.1846876384890441,
        "volume24h": 79619.18217683432,
        "liquidityChangePercentage24h": null,
        "volume24hChangePercentage24h": null,
        "trade24h": 2331,
        "trade24hChangePercent": -54.48154657293497,
        "uniqueWallet24h": 841,
        "uniqueWallet24hChangePercent": -45.28301886792453
      },
      {
        "address": "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
        "base": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "bonfidaLock": null,
        "createdAt": "2023-06-30T19:06:24.650Z",
        "lpBurn": null,
        "name": "SOL-USDC",
        "quote": {
          "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "decimals": 6,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v%2Flogo.png",
          "symbol": "USDC"
        },
        "sollamaLock": null,
        "source": "whirlpool",
        "liquidity": 8414350.772293106,
        "liquidityChangePercentage24h": null,
        "price": 139.3062900883198,
        "trade24h": 33630,
        "trade24hChangePercent": -38.17787418655097,
        "uniqueWallet24h": 3868,
        "uniqueWallet24hChangePercent": -32.18793828892005,
        "volume24h": 35903348.906535,
        "volume24hChangePercentage24h": null
      },
      {
        "address": "FRhB8L7Y9Qq41qZXYLtC2nw8An1RJfLLxRF2x9RwLLMo",
        "base": {
          "address": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
          "decimals": 9,
          "symbol": "POPCAT",
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Farweave.net%2FA1etRNMKxhlNGTf-gNBtJ75QJJ4NJtbKh_UXQTlLXzI"
        },
        "bonfidaLock": null,
        "createdAt": "2023-12-12T21:04:17.513Z",
        "liquidity": 7980312.656224441,
        "lpBurn": {
          "lpMint": "mUVPGfAcfQH3RA8EucVvrisxxyRu6WomPbPZdZUnrd9",
          "lpCurrentSupply": 3736.308885971,
          "lpReserve": 86207.905029069,
          "burnRatio": 95.66593239365795,
          "decimals": 9,
          "pairAddress": "FRhB8L7Y9Qq41qZXYLtC2nw8An1RJfLLxRF2x9RwLLMo"
        },
        "name": "POPCAT-SOL",
        "price": 0.00430597231372549,
        "quote": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "sollamaLock": null,
        "source": "raydium",
        "trade24h": 16581,
        "trade24hChangePercent": -24.952475785281074,
        "uniqueWallet24h": 2181,
        "uniqueWallet24hChangePercent": -21.546762589928058,
        "volume24h": 4180857.948318029
      },
      {
        "address": "FuemMjepntbzthvSEVmDGnfq7YWr8UebZrAXJrP46VtF",
        "base": {
          "address": "CJMihkPYswa3k6az9SUbepjKnkJQ6KWpGG5p9qW9n7NV",
          "decimals": 9,
          "symbol": "LIKE",
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fnftstorage.link%2Fipfs%2Fbafkreihgxccsgvc4wzcsulh5ayzm6cbhowgbaipqdykbqk7p63mkxmmuya"
        },
        "bonfidaLock": null,
        "createdAt": "2024-03-17T06:57:19.049Z",
        "liquidity": 7528755.320985452,
        "lpBurn": {
          "lpMint": "Aji5auH1STzAfsAWedtfMcV1MJE6XqF75i7hVZGe4KrB",
          "lpCurrentSupply": 156.259577872,
          "lpReserve": 15732288.982130146,
          "burnRatio": 99.9990067587873,
          "decimals": 9,
          "pairAddress": "FuemMjepntbzthvSEVmDGnfq7YWr8UebZrAXJrP46VtF"
        },
        "name": "LIKE-SOL",
        "price": 0.0000029071584756286587,
        "quote": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "sollamaLock": null,
        "source": "raydium",
        "trade24h": 11,
        "trade24hChangePercent": -66.66666666666666,
        "uniqueWallet24h": 10,
        "uniqueWallet24hChangePercent": -44.44444444444444,
        "volume24h": 10.999609012995547
      },
      {
        "address": "8iibPkw7zbNHMPcihHeBgcL7rDnHteZb2NfvTy8bNm7d",
        "base": {
          "address": "5oVNBeEEQvYi1cX3ir8Dx5n1P7pdxydbGF2X4TxVusJm",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fbafkreiflz2xxkfn33qjch2wj55bvbn33q3s4mmb6bye5pt3mpgy4t2wg4e.ipfs.nftstorage.link%2F",
          "symbol": "INF"
        },
        "bonfidaLock": null,
        "createdAt": "2024-03-12T07:57:26.697Z",
        "liquidity": 7389706.976147693,
        "lpBurn": null,
        "name": "INF-SOL",
        "price": 1.1978053239571775,
        "quote": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "sollamaLock": null,
        "source": "meteora_dlmm",
        "trade24h": 4747,
        "trade24hChangePercent": -36.36729222520107,
        "uniqueWallet24h": 2105,
        "uniqueWallet24hChangePercent": -35.95984180103437,
        "volume24h": 1421364.6168053397
      },
      {
        "address": "GeNc51GBjhXiYruWrx6VPh6xMNeTjYb5hUBpFJi9cW27",
        "base": {
          "address": "FLUXBmPhT3Fd1EDVFdg46YREqHBeNypn1h4EbnTzWERX",
          "decimals": 5,
          "symbol": "FLUXB",
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fbafybeiakyhwwesdvxpikjn4kyqddira3hjpjfcn26ycrrezt65bfa7r3gm.ipfs.nftstorage.link"
        },
        "bonfidaLock": null,
        "createdAt": "2023-11-10T16:00:41.728Z",
        "lpBurn": null,
        "name": "FLUXB-SOL",
        "quote": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "sollamaLock": null,
        "source": "fluxbeam",
        "liquidity": 7215678.993199982,
        "liquidityChangePercentage24h": null,
        "price": 0.00041242645360635747,
        "trade24h": 127,
        "trade24hChangePercent": -37.745098039215684,
        "uniqueWallet24h": 105,
        "uniqueWallet24hChangePercent": -35.97560975609756,
        "volume24h": 36546.117834080316,
        "volume24hChangePercentage24h": null
      },
      {
        "address": "DvWpLaNUPqoCGn4foM6hekAPKqMtADJJbJWhwuMiT6vK",
        "base": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "bonfidaLock": null,
        "createdAt": "2023-07-11T08:41:41.433Z",
        "lpBurn": null,
        "name": "SOL-bSOL",
        "quote": {
          "address": "bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FbSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1%2Flogo.png",
          "symbol": "bSOL"
        },
        "sollamaLock": null,
        "source": "meteora",
        "liquidity": 6924972.27154549,
        "liquidityChangePercentage24h": null,
        "price": 0.8878505093086337,
        "trade24h": 3114,
        "trade24hChangePercent": -36.93803159173755,
        "uniqueWallet24h": 1147,
        "uniqueWallet24hChangePercent": -28.3125,
        "volume24h": 1106859.8091431465,
        "volume24hChangePercentage24h": null
      },
      {
        "address": "4DoNfFBfF7UokCC2FQzriy7yHK6DY6NVdYpuekQ5pRgg",
        "base": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "createdAt": "2023-02-28T03:00:02.253Z",
        "name": "SOL-USDC",
        "quote": {
          "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "decimals": 6,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v%2Flogo.png",
          "symbol": "USDC"
        },
        "source": "phoenix",
        "liquidity": 6778757.545344405,
        "liquidityChangePercentage24h": null,
        "price": 139.31548909130578,
        "trade24h": 26962,
        "trade24hChangePercent": -36.81719119818152,
        "uniqueWallet24h": 4174,
        "uniqueWallet24hChangePercent": -29.505151156899174,
        "volume24h": 40172666.645672,
        "volume24hChangePercentage24h": null
      },
      {
        "address": "C8Gr6AUuq9hEdSYJzoEpNcdjpojPZwqG5MtQbeouNNwg",
        "base": {
          "address": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
          "decimals": 6,
          "symbol": "JUP",
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fstatic.jup.ag%2Fjup%2Ficon.png"
        },
        "bonfidaLock": null,
        "createdAt": "2024-01-30T01:03:33.497Z",
        "liquidity": 6542560.732188154,
        "lpBurn": null,
        "name": "JUP-SOL",
        "price": 0.007283236772959298,
        "quote": {
          "address": "So11111111111111111111111111111111111111112",
          "decimals": 9,
          "icon": "https://img.fotofolio.xyz/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fsolana-labs%2Ftoken-list%2Fmain%2Fassets%2Fmainnet%2FSo11111111111111111111111111111111111111112%2Flogo.png",
          "symbol": "SOL"
        },
        "sollamaLock": null,
        "source": "meteora_dlmm",
        "trade24h": 1350,
        "trade24hChangePercent": -24.70719464584495,
        "uniqueWallet24h": 254,
        "uniqueWallet24hChangePercent": -23.49397590361446,
        "volume24h": 302012.9652417423
      }
    ],
    "total": 587074
  }
}

Note: Replace YOUR_API_KEY in the request headers with your actual API key. Adjust the address, offset, and limit parameters as needed to tailor the request to your requirements. The x-chain header specifies the blockchain network for the request.

The total response field returns the total markets of a single token. In the above response, $SOL has 587074 markets at the time of query.