Skip to main content
GET
/
insights
/
v1
/
nfts
/
transfers
Get NFT transfers
curl --request GET \
  --url https://data-api.b3.fun/insights/v1/nfts/transfers
{
  "data": [
    {
      "token_id": "<string>",
      "chain_id": 123,
      "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": "erc721",
      "amount": "<string>",
      "nft_metadata": {
        "name": "<string>",
        "description": "<string>",
        "image_url": "<string>",
        "video_url": "<string>",
        "animation_url": "<string>",
        "background_color": "<string>",
        "external_url": "<string>",
        "status": "<string>",
        "metadata_url": "<string>",
        "owner_addresses": [
          "<string>"
        ],
        "extra_metadata": {
          "attributes": [
            {
              "trait_type": "<string>",
              "value": "<string>",
              "display_type": "<string>"
            }
          ],
          "properties": {}
        },
        "collection": {
          "name": "<string>",
          "description": "<string>",
          "image_url": "<string>",
          "banner_image_url": "<string>",
          "featured_image_url": "<string>",
          "external_link": "<string>"
        },
        "contract": {
          "chain_id": 1,
          "address": "vitalik.eth",
          "name": "<string>",
          "symbol": "<string>",
          "type": "erc721"
        }
      },
      "nft_sale": {
        "transaction_hash": "<string>",
        "items_sold": [
          {
            "token_address": "vitalik.eth",
            "token_id": "<string>",
            "amount": "<string>",
            "token_type": "<string>",
            "from_address": "vitalik.eth",
            "to_address": "vitalik.eth"
          }
        ],
        "payment": [
          {
            "token_address": "vitalik.eth",
            "token_id": "<string>",
            "amount": "<string>",
            "token_type": "<string>",
            "from_address": "vitalik.eth",
            "to_address": "vitalik.eth"
          }
        ],
        "marketplace_address": "<string>",
        "marketplace_name": "<string>"
      }
    }
  ]
}

Path Parameters

​
ownerAddress
string
required
Example:

"vitalik.eth"

​
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"

​
block_number_from

Filter by block number greater 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,
sale
Example:

"mint"

​
sales
enum<string>
default:false

Whether to include sale details for NFT transfers

Available options:
true,
false
Example:

"false"

​
resolve_metadata_links
enum<string>
default:true

Whether to resolve metadata IPFS or Arweave links

Available options:
true,
false
Example:

"false"

Response

Success

​
data
object[]
required