Get Historical Token Owners

This endpoint returns all Accounts that own a given token at a given timestamp, identified by a contract address and ordered by owner address (supports pagination). Supported chains: ethereum, polygon, arbitrum, optimism, base, avalanche, nova.

Parameters

Parameter	Description	Type
chain_id	A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query.	string
contract_address	required The contract address of the token to retrieve owners for.	string
timestamp	The timestamp time at which you wish to fetch the token owners at (in seconds since the Unix epoch or ISO-8601 format).	date-time
limit	The maximum number of results to retrieve (default 100).	integer

PythonNodecURL

import requests url = "https://api.transpose.io/token/historical-token-owners" headers = { 'Content-Type': 'application/json', 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG', } params = { "chain_id": "ethereum", "contract_address": "0x3B803cd0515DCff3aC958F2F11aF168b85147136", "timestamp": "2023-09-01", } response = requests.get(url, headers=headers, params=params) print(response.text) print('Credits charged:', response.headers.get('X-Credits-Charged', None))

const https = require('https'); const querystring = require('querystring'); const params = { chain_id: "ethereum", contract_address: "0x3B803cd0515DCff3aC958F2F11aF168b85147136", timestamp: "2023-09-01", } var options = { hostname: 'api.transpose.io', path: '/token/historical-token-owners?' + querystring.stringify(params), method: 'GET', headers: { 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' } }; var req = https.request(options, (res) => { console.log('Credits charged:', res.headers['x-credits-charged']); res.on('data', (d) => { process.stdout.write(d); }); }); req.on('error', (e) => { console.error(e); }); req.end();

curl -X GET \
    'https://api.transpose.io/token/historical-token-owners?chain_id=ethereum&contract_address=0x3B803cd0515DCff3aC958F2F11aF168b85147136&timestamp=2023-09-01' \
    -H 'X-API-KEY: BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' \

Got questions? Join our Discord

Discord is the primary home of the Transpose developer community. Join us to ask questions, share your work, and get help.