Get token transfers

curl --request GET \
  --url https://data-api.b3.fun/insights/v1/tokens/transfers

const options = {method: 'GET'};

fetch('https://data-api.b3.fun/insights/v1/tokens/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://data-api.b3.fun/insights/v1/tokens/transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.b3.fun/insights/v1/tokens/transfers"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://data-api.b3.fun/insights/v1/tokens/transfers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "meta": {
    "chain_id": 123,
    "address": "<string>",
    "signature": "<string>",
    "page": 123,
    "limit": 123,
    "total_items": 123,
    "total_pages": 123
  },
  "data": [
    {
      "block_number": "<string>",
      "block_timestamp": "<string>",
      "transaction_hash": "<string>",
      "from_address": "<string>",
      "to_address": "<string>",
      "log_index": 123,
      "contract_address": "<string>",
      "transfer_type": "mint",
      "token_type": "erc20",
      "amount": "<string>",
      "chain_id": 123,
      "block_hash": "<string>",
      "token_metadata": {
        "name": "<string>",
        "symbol": "<string>",
        "decimals": 123,
        "price_data": {
          "price_usd": 123,
          "usd_value": 123,
          "volume_24h_usd": 123,
          "market_cap_usd": 123,
          "circulating_supply": 123,
          "total_supply": 123,
          "percent_change_24h": 123,
          "price_timestamp": "<string>"
        }
      },
      "price_data": {
        "price_usd": 123,
        "usd_value": 123,
        "volume_24h_usd": 123,
        "market_cap_usd": 123,
        "circulating_supply": 123,
        "total_supply": 123,
        "percent_change_24h": 123,
        "price_timestamp": "<string>"
      }
    }
  ],
  "aggregations": null
}

{
  "meta": {
    "chain_id": 123,
    "address": "<string>",
    "signature": "<string>",
    "page": 123,
    "limit": 123,
    "total_items": 123,
    "total_pages": 123
  },
  "data": [
    {
      "block_number": "<string>",
      "block_timestamp": "<string>",
      "transaction_hash": "<string>",
      "from_address": "<string>",
      "to_address": "<string>",
      "log_index": 123,
      "contract_address": "<string>",
      "transfer_type": "mint",
      "token_type": "erc20",
      "amount": "<string>",
      "chain_id": 123,
      "block_hash": "<string>",
      "token_metadata": {
        "name": "<string>",
        "symbol": "<string>",
        "decimals": 123,
        "price_data": {
          "price_usd": 123,
          "usd_value": 123,
          "volume_24h_usd": 123,
          "market_cap_usd": 123,
          "circulating_supply": 123,
          "total_supply": 123,
          "percent_change_24h": 123,
          "price_timestamp": "<string>"
        }
      },
      "price_data": {
        "price_usd": 123,
        "usd_value": 123,
        "volume_24h_usd": 123,
        "market_cap_usd": 123,
        "circulating_supply": 123,
        "total_supply": 123,
        "percent_change_24h": 123,
        "price_timestamp": "<string>"
      }
    }
  ],
  "aggregations": null
}

GET

insights

tokens

transfers

Get token transfers

curl --request GET \
  --url https://data-api.b3.fun/insights/v1/tokens/transfers

const options = {method: 'GET'};

fetch('https://data-api.b3.fun/insights/v1/tokens/transfers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://data-api.b3.fun/insights/v1/tokens/transfers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.b3.fun/insights/v1/tokens/transfers"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://data-api.b3.fun/insights/v1/tokens/transfers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "meta": {
    "chain_id": 123,
    "address": "<string>",
    "signature": "<string>",
    "page": 123,
    "limit": 123,
    "total_items": 123,
    "total_pages": 123
  },
  "data": [
    {
      "block_number": "<string>",
      "block_timestamp": "<string>",
      "transaction_hash": "<string>",
      "from_address": "<string>",
      "to_address": "<string>",
      "log_index": 123,
      "contract_address": "<string>",
      "transfer_type": "mint",
      "token_type": "erc20",
      "amount": "<string>",
      "chain_id": 123,
      "block_hash": "<string>",
      "token_metadata": {
        "name": "<string>",
        "symbol": "<string>",
        "decimals": 123,
        "price_data": {
          "price_usd": 123,
          "usd_value": 123,
          "volume_24h_usd": 123,
          "market_cap_usd": 123,
          "circulating_supply": 123,
          "total_supply": 123,
          "percent_change_24h": 123,
          "price_timestamp": "<string>"
        }
      },
      "price_data": {
        "price_usd": 123,
        "usd_value": 123,
        "volume_24h_usd": 123,
        "market_cap_usd": 123,
        "circulating_supply": 123,
        "total_supply": 123,
        "percent_change_24h": 123,
        "price_timestamp": "<string>"
      }
    }
  ],
  "aggregations": null
}

{
  "meta": {
    "chain_id": 123,
    "address": "<string>",
    "signature": "<string>",
    "page": 123,
    "limit": 123,
    "total_items": 123,
    "total_pages": 123
  },
  "data": [
    {
      "block_number": "<string>",
      "block_timestamp": "<string>",
      "transaction_hash": "<string>",
      "from_address": "<string>",
      "to_address": "<string>",
      "log_index": 123,
      "contract_address": "<string>",
      "transfer_type": "mint",
      "token_type": "erc20",
      "amount": "<string>",
      "chain_id": 123,
      "block_hash": "<string>",
      "token_metadata": {
        "name": "<string>",
        "symbol": "<string>",
        "decimals": 123,
        "price_data": {
          "price_usd": 123,
          "usd_value": 123,
          "volume_24h_usd": 123,
          "market_cap_usd": 123,
          "circulating_supply": 123,
          "total_supply": 123,
          "percent_change_24h": 123,
          "price_timestamp": "<string>"
        }
      },
      "price_data": {
        "price_usd": 123,
        "usd_value": 123,
        "volume_24h_usd": 123,
        "market_cap_usd": 123,
        "circulating_supply": 123,
        "total_supply": 123,
        "percent_change_24h": 123,
        "price_timestamp": "<string>"
      }
    }
  ],
  "aggregations": null
}

Path Parameters

ownerAddress

string

required

Example:

"vitalik.eth"

contract_address

string

required

Example:

"vitalik.eth"

Query Parameters

chain

number[]

Use chain_id instead

Example:

[20, 56, 1]

chain_id

number[]

The chain ID(s) to request the data for. You can specify multiple chain IDs, up to a maximum of 55. Use repeated query parameters, e.g., ?chain_id=20&chain_id=56. Optional, because a single chain can as well be specified as a subdomain

Example:

[20, 56, 1]

limit

integer

default:20

The number of items to return

Required range: 0 < x <= 1000

Example:

20

page

integer | null

default:0

Page number (0-indexed). Maximum value depends on query parameters: 20 for regular queries, 500 when using aggregate or group_by parameters.

Required range: x >= 0

Example:

0

metadata

enum<string>

default:false

Whether to include metadata for the tokens

Available options:

true,

false

Example:

"false"

include_owners

enum<string>

default:false

Whether to include owner addresses in the NFT metadata (only if metadata is requested)

Available options:

true,

false

Example:

"false"

block_number_from

Filter by block number greater than or equal to

Example:

"1000000"

block_number_to

Filter by block number less than or equal to

Example:

"1000000"

block_timestamp_from

integer

Filter by block timestamp greater than or equal to

Required range: x > 0

Example:

1749768884

block_timestamp_to

integer

Filter by block timestamp less than or equal to

Required range: x > 0

Example:

1749768884

sort_order

enum<string>

default:desc

Sort order (asc or desc)

Available options:

asc,

desc

Example:

"desc"

transfer_type

enum<string>

Only include transfers of a certain type

Available options:

mint,

transfer,

burn

Example:

"mint"

token_types

enum<string>[]

The types of tokens to include in the response. Can be an empty array to include all types

Available options:

erc1155,

erc721,

erc20

Response

Success

Overview

Resources

Ecosystem Tools

User Experience

Data API

Learn

Get token transfers

Path Parameters

Query Parameters

Response