Skip to main content
GET
/
v1
/
vaults
/
holders
Get a count of unique token holders over time
curl --request GET \
  --url https://api.paxoslabs.com/v1/vaults/holders
[
  {
    "id": 1,
    "vault": "0x19e099b7aed41fa52718d780dda74678113c0b32",
    "timestamp": 1733053355,
    "total_count": 888
  }
]

Query Parameters

​
vault_address
string

The address of the vault. Optional.

Example:

"0x9Ed15383940CC380fAEF0a75edacE507cC775f22"

​
time_start
integer

Return results starting from this timestamp. Optional.

Example:

1732679943

​
time_end
integer

Return results before this timestamp. Optional.

Example:

1738680000

​
latest
boolean

Indicate if the results should show the most recent snapshot of holders count. Defaults to false. Optional.

Example:

false

Response

Successful response.

​
id
integer

ID of the blockchain.

Example:

1

​
vault
string

Ethereum address of the vault.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x19e099b7aed41fa52718d780dda74678113c0b32"

​
timestamp
integer

Unix timestamp when the transaction occurred.

Example:

1733053355

​
total_count
integer

Total number of unique holders at this timestamp, cumulative.

Example:

888