Crypto

NFT Token Metadata

Every token in an NFT contract — metadata, traits, media, collection and mint details, and optionally its owner.

nft-tokenscryptonftethereumon-chain

0 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/nft-tokens/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

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/nft-tokens/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "contractAddresses": [        "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"      ],      "chain": "eth-mainnet",      "maxNftsPerContract": 1000,      "fetchOwners": false    }  }'

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

contractAddresses
string[]
Contract addresses
NFT contracts to walk, on the selected chain. Replaces the source script’s collections_addresses.json.
Default
["0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"]
Example
0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D
chain
enum
Chain
One chain per run. The same address on two chains is two different collections, so rows are keyed by chain.
Default
eth-mainnet
Allowed values
eth-mainnet
polygon-mainnet
arb-mainnet
opt-mainnet
base-mainnet

Advanced

maxNftsPerContract
number
Max NFTs per contract
Stops the page walk once this many tokens are collected. A run that hits it says so in its warnings.
Default
1000
Range
1 to 200000
pageSize
number
Tokens per request
Alchemy caps this at 100 and quietly returns 100 for anything larger.
Default
100
Range
1 to 100
requestDelayMs
number
Delay between requests (ms)
Default
200
Range
0 to 30000
apiKey
string
Alchemy API key
Overrides ALCHEMY_API_KEY for this run. With neither set the run fails immediately rather than collecting nothing.
Default
none

Ownership

fetchOwners
boolean
Fetch current owners
One extra request per token — a 10,000-token collection costs 10,000 calls. Off unless you need holders.
Default
false
maxOwnerLookups
number
Max owner lookups per run
Ceiling on those extra calls across the whole run. Tokens past it keep whatever owners an earlier run found.
Default
250
Range
0 to 100000

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": {    "contractAddresses": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Contract addresses",      "description": "NFT contracts to walk, on the selected chain. Replaces the source script’s collections_addresses.json.",      "default": [        "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"      ],      "examples": [        "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"      ]    },    "chain": {      "type": "string",      "enum": [        "eth-mainnet",        "polygon-mainnet",        "arb-mainnet",        "opt-mainnet",        "base-mainnet"      ],      "title": "Chain",      "description": "One chain per run. The same address on two chains is two different collections, so rows are keyed by chain.",      "default": "eth-mainnet"    },    "maxNftsPerContract": {      "type": "number",      "minimum": 1,      "maximum": 200000,      "title": "Max NFTs per contract",      "description": "Stops the page walk once this many tokens are collected. A run that hits it says so in its warnings.",      "default": 1000    },    "fetchOwners": {      "type": "boolean",      "title": "Fetch current owners",      "description": "One extra request per token — a 10,000-token collection costs 10,000 calls. Off unless you need holders.",      "default": false    },    "maxOwnerLookups": {      "type": "number",      "minimum": 0,      "maximum": 100000,      "title": "Max owner lookups per run",      "description": "Ceiling on those extra calls across the whole run. Tokens past it keep whatever owners an earlier run found.",      "default": 250    },    "pageSize": {      "type": "number",      "minimum": 1,      "maximum": 100,      "title": "Tokens per request",      "description": "Alchemy caps this at 100 and quietly returns 100 for anything larger.",      "default": 100    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 30000,      "title": "Delay between requests (ms)",      "default": 200    },    "apiKey": {      "type": "string",      "maxLength": 2000,      "title": "Alchemy API key",      "description": "Overrides ALCHEMY_API_KEY for this run. With neither set the run fails immediately rather than collecting nothing."    }  }}

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/nft-tokens/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "contractAddresses": [        "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"      ],      "chain": "eth-mainnet",      "maxNftsPerContract": 1000,      "fetchOwners": false    }  }' | 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.

No rows collected yet, so no fields have been observed. Run the scraper once and they will appear here.