Export token holders as CSV

Exports the holders of a specific token as a CSV file.

GET /tokens/{address_hash_param}/holders/csv

Export token holders as CSV

cURL

curl --request GET \
  --url 'https://api.blockscout.com/{chain_id}/api/v2/tokens/{address_hash_param}/holders/csv?apikey='

404

{
  "message": "Resource not found"
}

Authorizations

apikey · string · query · required

API key for authentication. Required for all Pro API endpoints. Obtain your API key at https://dev.blockscout.com/

Path Parameters

address_hash_param · string · required

Address hash in the path

Pattern: ^0x([A-Fa-f0-9]{40})$

Query Parameters

apikey · string · required

API key for rate limiting or for sensitive endpoints

key · string

Secret key for getting access to restricted resources

from_period · Option 1 · string NullString · string · required

Start of the time period (ISO 8601 format) in CSV export

Pattern: ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])(?:T(?:[01]\d|2[0-3])(?:(?::|%3A)[0-5]\d(?:(?::|%3A)[0-5]\d(?:\.\d{1,9})?)?)?(?:Z|(?:\+|%2B|-)(?:[01]\d|2[0-3])(?:(?::|%3A)[0-5]\d)?)?)?$

to_period · Option 1 · string NullString · string · required

End of the time period (ISO 8601 format) In CSV export

Pattern: ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])(?:T(?:[01]\d|2[0-3])(?:(?::|%3A)[0-5]\d(?:(?::|%3A)[0-5]\d(?:\.\d{1,9})?)?)?(?:Z|(?:\+|%2B|-)(?:[01]\d|2[0-3])(?:(?::|%3A)[0-5]\d)?)?)?$

filter_type · enum<string> string

Filter type in CSV export

Available options: address

filter_value · enum<string> string

Filter value in CSV export

Available options: to, from

Response

200

application/csv

CSV file of token holders.