Browse API groups
Address Names API
The display name for an address: a curated Quantascan label when one exists, otherwise a unique auto-generated nickname. Nicknames are a pure function of the address — the algorithm, word lists and golden vectors are published at /nicknames/v1/ so you can compute virtually every name offline and use these endpoints only for curated labels and the small collision-arbitration list.
GET
/api/v1/{chain}/names/{address}QRL 2.0QRL (PoW)Name For Address
The display name for one address.
Always returns a name, also for an address we have never indexed: the nickname depends on the address alone.
Path parameters
addressrequiredstring
Response 200 · AddressName
addressstringrequiredchainstringrequirednamestringrequiredsourcestringrequired'official_label' or 'nickname'categorystring | nullLabel category when source='official_label'nicknamestringrequiredThe auto-generated name, regardless of sourceassignedbooleanrequiredDeprecated, always true. Under spec v3 the nickname is a pure function of the address and final the moment it is computed.attemptintegerDeprecated, always 0. Spec v3 has no collision attempts.ruleset_versionstringrequiredRequest examples
curl -s "https://quantascan.io/api/v1/qrl2/names/<address>" \
-H "Authorization: Bearer qs_YOUR_API_KEY"GET
/api/v1/{chain}/names/directoryQRL 2.0QRL (PoW)Label Directory
All curated Quantascan labels for the chain — fetch once, join locally.
Query parameters
limitoptionalintegermin 1 · max 10000default 2000offsetoptionalintegermin 0default 0
Response 200 · LabelDirectory
▸itemsLabelDirectoryItem[]
itemsLabelDirectoryItem[]addressstringrequiredlabelstringrequiredcategorystringrequiredtotalintegerchainstringrequiredRequest examples
curl -s "https://quantascan.io/api/v1/qrl2/names/directory" \
-H "Authorization: Bearer qs_YOUR_API_KEY"POST
/api/v1/{chain}/names/resolveQRL 2.0QRL (PoW)Resolve Names
Resolve display names for many addresses in one call.
One request = one metered API call, so a view with thousands of wallets costs a handful of calls rather than thousands.
Response 200 · AddressNamesList
▸itemsAddressName[]
itemsAddressName[]addressstringrequiredchainstringrequirednamestringrequiredsourcestringrequired'official_label' or 'nickname'categorystring | nullLabel category when source='official_label'nicknamestringrequiredThe auto-generated name, regardless of sourceassignedbooleanrequiredDeprecated, always true. Under spec v3 the nickname is a pure function of the address and final the moment it is computed.attemptintegerDeprecated, always 0. Spec v3 has no collision attempts.ruleset_versionstringrequiredcountintegerRequest examples
curl -s -X POST "https://quantascan.io/api/v1/qrl2/names/resolve" \
-H "Authorization: Bearer qs_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"addresses":["Qc0e6dd0e844e0048dcb0bd3fdcc44a970beca38d"]}'All endpoints verified against a live indexer. Need the raw spec? See openapi.json or the API overview.