Token Holder Details

Information on token holders

get
Token_Holder_Details

https//data-api.defipulse.com/api/v1/bloxy/token/token_holders_details
Returns detailed information on token holders, filtered by the count of token send/receive transactions.
Request
Response
Request
Headers
api-key
required
string
Create a free account on data.defipulse.com to obtain an API-key
token
required
string
address of the token
Query Parameters
date
optional
string
on date
min_balance
optional
string
Minimum balance for holder. default is 1.0e-6
to_count_min
optional
string
Minimum count of receive token transactions default is 1
from_count_min
optional
string
Minimum count of send token transactions default is 0
limit
optional
string
Maximum amount of results in the list. default 10000, min 1, max 100000
offset
optional
string
Offset for the results in the list, default is 0
Form Data Parameters
format
optional
string
structure, table, csv
Response
200: OK
See details below
[
{
"address":"0xa5407eae9ba41422680e2e00537571bcc53efbfd",
"address_type":"DEX",
"to_count":12132,"uniq_senders":2724,
"from_count":8686,"uniq_receivers":1468,
"to_amount":96505920.9009473,
"from_amount":92359676.97346584,
"first_tx_at":"2020-04-20T03:05:26.000+00:00",
"last_tx_at":"2020-07-10T18:59:04.000+00:00",
"balance":4146243.9274814576,
"annotation":"sUSD v2, Curve.fi"
},...
...]

Return Parameters:

Return
Return
  • address, string : Token holder address

  • address_type, string : Type of address

  • balance, number : Balance

  • to_count, number : Transfers to holder TX count

  • uniq_senders, number : Unique senders to holder

  • from_count, number : Transfers from holder TX count

  • uniq_receivers, number : Unique recievers from holder

  • to_amount, number : Received amount

  • from_amount, number : Sent amount

  • first_tx_at, datetime : Timestamp of the first transfer

  • last_tx_at, datetime : Timestamp of the last transfer

  • annotation, string : Token holder address annotation