GET
/
insights
/
v1
/
tokens
/
transfers
/
{contract_address}
Get token transfers by contract
curl --request GET \
  --url https://data-api.b3.fun/insights/v1/tokens/transfers/{contract_address}
{
  "data": [
    {
      "block_number": "<string>",
      "block_hash": "<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,
      "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": "<any>",
  "meta": {
    "chain_id": 123,
    "address": "<string>",
    "signature": "<string>",
    "page": 123,
    "limit": 123,
    "total_items": 123,
    "total_pages": 123
  }
}

Path Parameters

​
contract_address
string
required
Example:

"vitalik.eth"

Query Parameters

​
chain
number[]
deprecated

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"

Response

200
application/json

Success

The response is of type object.