Crypto

DeBank Protocol Holders

Top holders of DeFi protocols on DeBank — wallet, USD deposited, share of TVL and rank — with protocol details.

debank-holdersdebankcryptodefiholderswhalestvl

500 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/debank-holders/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 500 rows, this download costs 5 credits when the data is fresh enough, or 10 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/debank-holders/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "protocolIds": [        "eth2",        "lido",        "aave3",        "uniswap3",        "curve"      ],      "maxHoldersPerProtocol": 100,      "pageSize": 100,      "requestDelayMs": 800    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

protocolIds
string[]
Protocol ids
DeBank protocol slugs — the `eth2` in debank.com/protocols/eth2. One paged sweep per id.
Default
["eth2","lido","aave3","uniswap3","curve"]
Example
eth2
maxHoldersPerProtocol
number
Max holders per protocol
Ceiling per protocol. Protocols have tens to hundreds of thousands of holders, so this is always a top-N, and a run that hits it says so in its warnings.
Default
100
Range
1 to 50000

Advanced

pageSize
number
Holders per request
DeBank's own table asks for 20; 100 is the most one request returns, and anonymous callers are served only the first page of the ranking.
Default
100
Range
1 to 100
requestDelayMs
number
Delay between requests (ms)
Default
800
Range
0 to 60000
requestAttempts
number
Attempts per request
Applies to transport failures and 5xx only. A signature-gate refusal is never retried — it is not transient.
Default
3
Range
1 to 8
resolveProtocolMetadata
boolean
Resolve protocol metadata
Fetches the signed /protocol/list catalogue once per run (~15 MB, ~2 s) to name each protocol and to tell an unknown slug apart from a blocked request.
Default
true

Authentication

signedHeaders
string
Signed request headers (JSON)
Optional override. Every request is signed automatically; headers pasted here replace the computed ones and are valid for one exact request only.
Default
none
Example
{"x-api-ts":"…","x-api-nonce":"…","x-api-ver":"v2","x-api-sign":"…","account":"…"}

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "protocolIds": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Protocol ids",      "description": "DeBank protocol slugs — the `eth2` in debank.com/protocols/eth2. One paged sweep per id.",      "default": [        "eth2",        "lido",        "aave3",        "uniswap3",        "curve"      ],      "examples": [        "eth2"      ]    },    "maxHoldersPerProtocol": {      "type": "number",      "minimum": 1,      "maximum": 50000,      "title": "Max holders per protocol",      "description": "Ceiling per protocol. Protocols have tens to hundreds of thousands of holders, so this is always a top-N, and a run that hits it says so in its warnings.",      "default": 100    },    "pageSize": {      "type": "number",      "minimum": 1,      "maximum": 100,      "title": "Holders per request",      "description": "DeBank's own table asks for 20; 100 is the most one request returns, and anonymous callers are served only the first page of the ranking.",      "default": 100    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "default": 800    },    "requestAttempts": {      "type": "number",      "minimum": 1,      "maximum": 8,      "title": "Attempts per request",      "description": "Applies to transport failures and 5xx only. A signature-gate refusal is never retried — it is not transient.",      "default": 3    },    "resolveProtocolMetadata": {      "type": "boolean",      "title": "Resolve protocol metadata",      "description": "Fetches the signed /protocol/list catalogue once per run (~15 MB, ~2 s) to name each protocol and to tell an unknown slug apart from a blocked request.",      "default": true    },    "signedHeaders": {      "type": "string",      "maxLength": 2000,      "title": "Signed request headers (JSON)",      "description": "Optional override. Every request is signed automatically; headers pasted here replace the computed ones and are valid for one exact request only.",      "examples": [        "{\"x-api-ts\":\"…\",\"x-api-nonce\":\"…\",\"x-api-ver\":\"v2\",\"x-api-sign\":\"…\",\"account\":\"…\"}"      ]    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/debank-holders/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "protocolIds": [        "eth2",        "lido",        "aave3",        "uniswap3",        "curve"      ],      "maxHoldersPerProtocol": 100,      "pageSize": 100,      "requestDelayMs": 800    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
cex_name	string	1%
cumulative_rate	number	100%
holder_address	string	100%
holder_label	string	1%
holder_rank	number	100%
holder_usd_value	number	100%
is_cex_deposit_address	boolean	1%
page_start	number	100%
protocol_chain	string	100%
protocol_holder_count	number	100%
protocol_id	string	100%
protocol_name	string	100%
protocol_site_url	string	100%
protocol_tvl_usd	number	100%
share_rate	number	100%
top_deposit_symbols	array	100%
total_holder_count	number	100%
created_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
updated_at	date	100%
wallet_born_at	date	100%
_id	string	100%