Get Owners by Contract Address

This endpoint returns all Accounts that own a given token, identified by a contract address (supports pagination). Ownership and balances are only updated once the underlying transaction causing the change in ownership/balance is confirmed by the network (roughly ~10 minutes on all chains). Supported chains: ethereum, polygon, optimism, scroll, arbitrum, base, avalanche.

Looking for historical token data? Check out our historical_token_owners, historical_token_balances_by_account, and historical_native_token_balance_by_account endpoints to query balance and ownership data at a particular timestamp.

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 (supports ENS names).	string
limit	The maximum number of results to retrieve (default 100).	string

PythonNodecURL

import requests url = "https://api.transpose.io/token/owners-by-contract-address" headers = { 'Content-Type': 'application/json', 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG', } params = { "chain_id": "ethereum", "contract_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", } 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: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", } var options = { hostname: 'api.transpose.io', path: '/token/owners-by-contract-address?' + 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/owners-by-contract-address?chain_id=ethereum&contract_address=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2' \
    -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.