Crypto

CryptoPunks Leaderboard

The 100 largest CryptoPunks holders — rank, wallet, ENS name and punks held, with optional social profiles.

cryptopunks-leaderboardcryptopunkscryptonftholdersethereum

101 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/cryptopunks-leaderboard/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 101 rows, this download costs 2 credits when the data is fresh enough, or 4 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/cryptopunks-leaderboard/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "maxHolders": 100,      "enrichWithOpenSea": false,      "maxEnriched": 100,      "enrichmentDelayMs": 500    }  }'

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

maxHolders
number
Max holders per run
The page publishes exactly 100 rows and has no pagination, so lowering this is the only thing that changes the row count.
Default
100
Range
1 to 1000

Enrichment

enrichWithOpenSea
boolean
Enrich wallets via OpenSea
Adds display name, bio, avatar and Twitter handle per wallet. One extra request each, against a host that blocks aggressively — a refusal degrades the row, it does not fail the run.
Default
false
maxEnriched
number
Max wallets to enrich
Ceiling on the OpenSea half only. Wallets past it keep their leaderboard fields.
Default
100
Range
1 to 1000
enrichmentDelayMs
number
Delay between OpenSea lookups (ms)
The legacy script slept 5000ms here. 500ms held across the wallets tested; raise it if blocks start appearing in the summary.
Default
500
Range
0 to 60000
fetchAccountPages
boolean
Fetch each wallet's account page
Adds the exact last-active timestamp, the punk indices held, the type breakdown and lifetime buy/sell totals. One extra page per wallet, and those pages run from 300KB to 3.5MB each — a full pass moves hundreds of megabytes.
Default
false
maxAccountPages
number
Max account pages to fetch
Ceiling on the account-page half only. Wallets past it keep every other field.
Default
100
Range
1 to 1000
accountPageDelayMs
number
Delay between account page fetches (ms)
500ms held across all 100 wallets with no refusal. The page itself takes 1-3s to arrive, so the delay is a small part of the total.
Default
500
Range
0 to 60000

Advanced

openSeaGraphqlUrl
string
OpenSea GraphQL endpoint
Escape hatch. OpenSea has moved this endpoint once already (opensea.io/__api/graphql/ → gql.opensea.io/graphql).
Default
https://gql.opensea.io/graphql
Example
https://gql.opensea.io/graphql

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": {    "maxHolders": {      "type": "number",      "minimum": 1,      "maximum": 1000,      "title": "Max holders per run",      "description": "The page publishes exactly 100 rows and has no pagination, so lowering this is the only thing that changes the row count.",      "default": 100    },    "enrichWithOpenSea": {      "type": "boolean",      "title": "Enrich wallets via OpenSea",      "description": "Adds display name, bio, avatar and Twitter handle per wallet. One extra request each, against a host that blocks aggressively — a refusal degrades the row, it does not fail the run.",      "default": false    },    "maxEnriched": {      "type": "number",      "minimum": 1,      "maximum": 1000,      "title": "Max wallets to enrich",      "description": "Ceiling on the OpenSea half only. Wallets past it keep their leaderboard fields.",      "default": 100    },    "enrichmentDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between OpenSea lookups (ms)",      "description": "The legacy script slept 5000ms here. 500ms held across the wallets tested; raise it if blocks start appearing in the summary.",      "default": 500    },    "openSeaGraphqlUrl": {      "type": "string",      "maxLength": 2000,      "title": "OpenSea GraphQL endpoint",      "description": "Escape hatch. OpenSea has moved this endpoint once already (opensea.io/__api/graphql/ → gql.opensea.io/graphql).",      "default": "https://gql.opensea.io/graphql",      "examples": [        "https://gql.opensea.io/graphql"      ]    },    "fetchAccountPages": {      "type": "boolean",      "title": "Fetch each wallet's account page",      "description": "Adds the exact last-active timestamp, the punk indices held, the type breakdown and lifetime buy/sell totals. One extra page per wallet, and those pages run from 300KB to 3.5MB each — a full pass moves hundreds of megabytes.",      "default": false    },    "maxAccountPages": {      "type": "number",      "minimum": 1,      "maximum": 1000,      "title": "Max account pages to fetch",      "description": "Ceiling on the account-page half only. Wallets past it keep every other field.",      "default": 100    },    "accountPageDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between account page fetches (ms)",      "description": "500ms held across all 100 wallets with no refusal. The page itself takes 1-3s to arrive, so the delay is a small part of the total.",      "default": 500    }  }}

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/cryptopunks-leaderboard/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "maxHolders": 100,      "enrichWithOpenSea": false,      "maxEnriched": 100,      "enrichmentDelayMs": 500    }  }' | 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
address	string	100%
bids_placed_count	number	99%
ens_name	string	24%
instagram_username	string	1%
is_stash_contract	boolean	99%
last_active_days_approx	number	99%
last_active_label	string	99%
opensea_banner_image_url	string	20%
opensea_bio	string	16%
opensea_collection_count	number	99%
opensea_display_name	string	24%
opensea_ens_name	string	23%
opensea_external_url	string	2%
opensea_follower_count	number	99%
opensea_following_count	number	99%
opensea_image_url	string	30%
opensea_is_compromised	boolean	99%
opensea_is_verified	boolean	99%
opensea_portfolio_value_native	number	99%
opensea_portfolio_value_symbol	string	99%
opensea_portfolio_value_usd	number	99%
opensea_url	string	99%
opensea_username	string	2%
punk_indexes	array	100%
punk_type_counts	object	99%
punks_for_sale_count	number	99%
punks_held	number	100%
punks_owned_count	number	99%
punks_with_bids_count	number	99%
punks_wrapped_count	number	99%
rank	number	100%
total_bought_eth	number	99%
total_bought_label	string	99%
total_bought_usd	number	99%
total_sold_eth	number	99%
total_sold_label	string	99%
total_sold_usd	number	99%
twitter_username	string	5%
account_checked_at	date	99%
created_at	date	100%
first_seen_at	date	100%
last_active_at	date	99%
last_seen_at	date	100%
opensea_checked_at	date	99%
updated_at	date	100%
_id	string	100%