Skip to main content
GET
https://api.etherscan.io
/
v2
/
api
curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokennftinventory&address=0x123432244443b54409430979df8333f9308a6040&contractaddress=0xed5af388653567af2f388e6224dc7c4b3241c544&page=1&offset=100&apikey=YourApiKeyToken"

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
      "TokenId": "453"
    },
    {
      "TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
      "TokenId": "8160"
    }
  ]
}
This is a PRO endpoint, available to any paid tier
This historical endpoint is throttled to 2 calls/s

​
Query Parameters

​
apikey
string
default:"YourApiKeyToken"
Your Etherscan API key.
​
chainid
string
default:"1"
Chain ID to query, eg 1 for Ethereum, 8453 for Base from our supported chains.
​
module
string
default:"account"
Set to account for this endpoint.
​
action
string
default:"addresstokennftinventory"
Set to addresstokennftinventory for this endpoint.
​
address
string
default:"0x123432244443b54409430979df8333f9308a6040"
Address to check for inventory.
​
contractaddress
string
default:"0xed5af388653567af2f388e6224dc7c4b3241c544"
ERC-721 token contract address to filter by.
​
page
integer
default:"1"
Page number for pagination.
​
offset
integer
default:"100"
Number of records per page. Limited to 1000 records per query; use the page parameter for subsequent records.
curl "https://api.etherscan.io/v2/api?chainid=1&module=account&action=addresstokennftinventory&address=0x123432244443b54409430979df8333f9308a6040&contractaddress=0xed5af388653567af2f388e6224dc7c4b3241c544&page=1&offset=100&apikey=YourApiKeyToken"

{
  "status": "1",
  "message": "OK",
  "result": [
    {
      "TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
      "TokenId": "453"
    },
    {
      "TokenAddress": "0xed5af388653567af2f388e6224dc7c4b3241c544",
      "TokenId": "8160"
    }
  ]
}