GET
/
insights
/
v1
/
nfts
/
owners
/
{contract_address}
Get NFT owners by contract
curl --request GET \
  --url https://data-api.b3.fun/insights/v1/nfts/owners/{contract_address}
[
  {
    "chain_id": "<string>",
    "token_address": "<string>",
    "owner_address": "<string>",
    "token_id": "<string>",
    "balance": "<string>"
  }
]

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

​
include_balances
enum<string>
default:false

Control if the result is an array of addresses only or an array of objects containing the address and balance

Available options:
true,
false
Example:

"true"

Response

200
application/json

Success