D3 API
D3 API Overview
Getting Started
Number of records to return for pagination.
25Number of records to skip for pagination.
0Top-level domain (TLD) of the name token to search for (comma separated list). Leave empty to search all available TLDs.
comSecond-level domain (SLD) of the name token to search for (comma separated list)
exampleTotal number of items.
100Unauthorized. API Key is missing or invalid.
Forbidden. API Key is missing SEARCH permission.
Top-level domain (TLD) of the name token to recommend (comma separated list). Leave empty to recommend all available TLDs.
comSecond-level domain (SLD) of the name token to recommend (comma separated list). Maximum of 5 SLDs allowed.
exampleSuccessful name recommendations
Second-level domain (SLD) of a name token.
exampleTop-level domain (TLD) of a name token.
comName availability status.
availablePossible values: Indicates whether the name is an EOI name or ICANN domain.
falseWhen status is registered, indicates if there's an active listing for it.
trueWhen name is registered, indicates registration expiration date. Past expiration date means that the name has expired, but in a grace period now. It could be renewed by the current owner, or be back on the market after a grace period has passed.
2025-05-15T00:00:00.000ZWhen name is reserved, indicates reservation expiration date. When name is available, indicates reservation expiration date for the reserved user.
2025-05-15T00:00:00.000ZPrice in USD (Deprecated, use registryUsdPrice instead)
9.99Price in USD
9.99Price in native token (Deprecated, use registryNativePrice instead)
1.23456Price in native token
1.23456Price in native token for active listing
1.23456Price in USD for active listing
1.23456Native blockchain currency. Will be null if tokenization is unsupported for given TLD
ETHClick URL for more information
https://d3.app/search?sld=example&product=example.com&partner=com&utm_source=developer&utm_medium=apiWhen name is locked, indicates lock expiration date. This is the date until which the domain remains locked, after which it may become available.
2025-05-15T00:00:00.000ZInvalid TLDs or other request issues
Forbidden. API Key is missing necessary permissions.
Second-level domain (SLD) of the name to mint.
exampleTop-level domain (TLD) of the name to mint.
comBad Request. Unable to mint the requested name token.
Unauthorized. API Key is missing or invalid.
Forbidden. API Key is missing NON_PREMIUM_MINT permission.
Conflict. Name token is already minted.
Top-level domain (TLD) of the name token to fetch payment options (comma separated list). Leave empty to fetch for all available TLDs.
comReturns payment options for name tokens.
Unauthorized. API Key is missing or invalid.
Forbidden. API Key is missing PURCHASE permission.
Top-level domain (TLD) of the name token.
comSecond-level domain (SLD) of the name token.
exampleStatus of the name token.
registeredPossible values: Second-level domain (SLD) of a name token. Only present when name token is registered.
exampleTop-level domain (TLD) of a name token. Only present when name token is registered.
comDomain registration date. Only present when name token is registered.
2024-05-15T00:00:00.000ZExpiration date of a registered name token. May return a past date if the token has expired. Only present when name token is registered.
2025-05-15T00:00:00.000ZOwner wallet address. Format is chain-specific. Only present when name token is registered.
0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532Minted Token ID. Only present when name token is registered.
20719405654568256184282804044567699961418926341258048728655171573148113774124NFT Smart Contract address. Only present when name token is registered.
0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8Chain ID of the blockchain network. Only present when name token is registered or waiting for finalization.
1Mint transaction hash. Only present when name token is waiting for finalization.
2sXoUFPpgFXRKiAXYUWkwtAEQd46azUEFwoebcYQbN6sToken image URL, only present if token is minted.
https://cdn.d3.app/tokens/1234567890abcdf123467890.pngBad Request. Wrong SLD or TLD format.
Unauthorized. API Key is missing or invalid.
Forbidden. API Key is missing NON_PREMIUM_MINT permission.
Not Found. Name token is not registered and mint is not in progress.
Chain ID of the blockchain network.
1NFT Smart Contract address.
0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8Minted Token ID.
20719405654568256184282804044567699961418926341258048728655171573148113774124Status of the name token.
registeredPossible values: Second-level domain (SLD) of a name token. Only present when name token is registered.
exampleTop-level domain (TLD) of a name token. Only present when name token is registered.
comDomain registration date. Only present when name token is registered.
2024-05-15T00:00:00.000ZExpiration date of a registered name token. May return a past date if the token has expired. Only present when name token is registered.
2025-05-15T00:00:00.000ZOwner wallet address. Format is chain-specific. Only present when name token is registered.
0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532Minted Token ID. Only present when name token is registered.
20719405654568256184282804044567699961418926341258048728655171573148113774124NFT Smart Contract address. Only present when name token is registered.
0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8Chain ID of the blockchain network. Only present when name token is registered or waiting for finalization.
1Mint transaction hash. Only present when name token is waiting for finalization.
2sXoUFPpgFXRKiAXYUWkwtAEQd46azUEFwoebcYQbN6sToken image URL, only present if token is minted.
https://cdn.d3.app/tokens/1234567890abcdf123467890.pngUnauthorized. API Key is missing or invalid.
Forbidden. API Key is missing SEARCH permission.
Not Found. Name token does not exist for this contract on this chain or contract not found.
Chain ID of the blockchain network.
1NFT Smart Contract address.
0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8List of token ids to lookup for
Status of the name token.
registeredPossible values: Second-level domain (SLD) of a name token. Only present when name token is registered.
exampleTop-level domain (TLD) of a name token. Only present when name token is registered.
comDomain registration date. Only present when name token is registered.
2024-05-15T00:00:00.000ZExpiration date of a registered name token. May return a past date if the token has expired. Only present when name token is registered.
2025-05-15T00:00:00.000ZOwner wallet address. Format is chain-specific. Only present when name token is registered.
0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532Minted Token ID. Only present when name token is registered.
20719405654568256184282804044567699961418926341258048728655171573148113774124NFT Smart Contract address. Only present when name token is registered.
0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8Chain ID of the blockchain network. Only present when name token is registered or waiting for finalization.
1Mint transaction hash. Only present when name token is waiting for finalization.
2sXoUFPpgFXRKiAXYUWkwtAEQd46azUEFwoebcYQbN6sToken image URL, only present if token is minted.
https://cdn.d3.app/tokens/1234567890abcdf123467890.pngBad Request. Wrong address or address type format.
Unauthorized. API Key is missing or invalid.
Forbidden. API Key is missing SEARCH permission.
Not Found. Chain or Contract not found.
Wallet address.
0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532Wallet address type.
Number of records to return for pagination.
25Number of records to skip for pagination.
0Total number of name tokens.
42Bad Request. Wrong address or address type format.
Unauthorized. API Key is missing or invalid.
Forbidden. API Key is missing SEARCH permission.
The domain name to set the web3 record for
example.orgThe symbol representing the asset or record, typically used as a short identifier (e.g., "BTC" for Bitcoin).
BTCThe address to associate with the domain and symbol. This is typically a blockchain address.
0x1234567890abcdef1234567890abcdef12345678The signature generated by the registrant's wallet, authorizing this operation.
0xabcdef...The UNIX timestamp (in milliseconds) when the signature expires.
1712345678901Bad Request. Signature has expired or invalid.
Unauthorized. API Key is missing or invalid.
Forbidden. API Key is missing WALLET_MAPPING permission.
Not Found. Domain does not exist.
No content
The domain name to delete the web3 record from
example.orgThe symbol representing the asset or record, typically used as a short identifier (e.g., "BTC" for Bitcoin).
BTCThe signature generated by the registrant's wallet, authorizing this operation.
0xabcdef...The UNIX timestamp (in milliseconds) when the signature expires.
1712345678901Bad Request. Signature has expired or invalid.
Unauthorized. API Key is missing or invalid.
Forbidden. API Key is missing WALLET_MAPPING permission.
Not Found. Domain does not exist.
No content
The name to set as the primary name for the wallet
example.ethThe signature to verify the request
0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdefThe timestamp when the signature expires
1735689600000No content
No content
The signature to verify the request
0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdefThe timestamp when the signature expires
1735689600000No content
No content
Last updated