Account Endpoints

Resolve an account identifier

Changed on

Resolve an ENS name (e.g. vitalik.eth), OpenSea username, or wallet address to canonical account info including address, username, and ENS name. The ENS path performs both forward resolution (name → address) and reverse lookup (address → canonical primary name). The address and ENS paths perform enrichment calls (username + ENS reverse lookup) in parallel. The username path only needs an ENS reverse lookup after the initial resolution and runs it sequentially. The ENS and username paths require an extra initial call and may be slower than the address path on cache misses.

get/api/v2/accounts/resolve/{identifier}

Request

Path parameters

identifierstring required

An ENS name (e.g. vitalik.eth), OpenSea username, or wallet address to resolve

Response

Resolved account info

addressstring required

The resolved wallet address

ens_namestring nullable

Primary ENS name, if available

usernamestring nullable

OpenSea username, if available

Example response

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "ens_name": "vitalik.eth"
}

Changes

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became nullable for the status

    • info

      added the media type */* for the response with the status

    • info

      added the media type */* for the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status