D3 API

D3 API Overview

D3 API allow for a fully custom integration of D3 features directly into your application. The API exposes an interface for interacting with Web3 Name Tokens on the D3 registry and allows searching, purchasing and minting, and more.

Getting Started

• Demo App

• Sample Source Code (See our github repository for an example app built using our APIs)

• Detailed Steps 👇

Sign up at D3 Developer Dashboard to get your own API keys today.

Swagger for these APIs can also be viewed at https://api-public.d3.app/swagger#/

Search name tokens returning availability and pricing

Provides search, combining availability information and pricing, both in native token and USD.

get

/v1/partner/search

Authorizations

Query parameters

limitany · min: 1 · max: 100 · default: 25

Number of records to return for pagination.

skipany

Number of records to skip for pagination.

tldstring

Top-level domain (TLD) of the name token to search for (comma separated list). Leave empty to search all available TLDs.

Example: com

sldstringrequired

Second-level domain (SLD) of the name token to search for (comma separated list)

Example: example

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/partner/search?sld=example' \
  --header 'Api-Key: YOUR_API_KEY'

200

401

403

200

{
  "total": 100,
  "pageItems": [
    {
      "sld": "example",
      "tld": "com",
      "isListed": true,
      "registrationExpiresAt": "2025-05-15T00:00:00.000Z",
      "reservationExpiresAt": "2025-05-15T00:00:00.000Z",
      "usdPrice": "9.99",
      "registryUsdPrice": "9.99",
      "nativeAmount": "1.23456",
      "registryNativePrice": "1.23456",
      "listNativePrice": "1.23456",
      "listUsdPrice": "1.23456",
      "nativeCurrency": "ETH",
      "clickUrl": "https://d3.app/search?sld=example&product=example.com&partner=com&utm_source=developer&utm_medium=api",
      "lockExpiresAt": "2025-05-15T00:00:00.000Z",
      "status": "available"
    }
  ]
}

Get name recommendations

Returns name recommendations based on the provided SLDs and TLDs

get

/v1/partner/recommendations

Authorizations

Query parameters

tldstring

Top-level domain (TLD) of the name token to recommend (comma separated list). Leave empty to recommend all available TLDs.

Example: com

sldstringrequired

Second-level domain (SLD) of the name token to recommend (comma separated list). Maximum of 5 SLDs allowed.

Example: example

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/partner/recommendations?sld=text' \
  --header 'Api-Key: YOUR_API_KEY'

200

400

403

200

[
  {
    "sld": "example",
    "tld": "com",
    "isListed": true,
    "registrationExpiresAt": "2025-05-15T00:00:00.000Z",
    "reservationExpiresAt": "2025-05-15T00:00:00.000Z",
    "usdPrice": "9.99",
    "nativeAmount": "1.23456",
    "nativeCurrency": "ETH",
    "clickUrl": "https://d3.app/search?sld=example&product=example.com&partner=com&utm_source=developer&utm_medium=api",
    "lockExpiresAt": "2025-05-15T00:00:00.000Z",
    "status": "available"
  }
]

Successful name recommendations

Mint a name token

Accepts mint name request. Only allows minting of non-premium name tokens (requires NON_PREMIUM_MINT permission).Token is not minted immediately but is scheduled for minting. Mint status could be checked using token status endpoint.

post

/v1/partner/mint

Authorizations

Body

sldstringrequired

Second-level domain (SLD) of the name to mint.

Example: example

tldstringrequired

Top-level domain (TLD) of the name to mint.

Example: com

userall ofrequired

User information required to mint the name.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/partner/mint' \
  --header 'Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"sld":"example","tld":"com","user":{"wallet":"0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532","email":"[e-mail]"}}'

202

400

401

403

409

202

{
  "tokenId": "20719405654568256184282804044567699961418926341258048728655171573148113774124",
  "contractAddress": "0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8",
  "chainId": "1"
}

Get supported payment methods for name tokens

Returns the supported payment options (contract and token addresses) for the provided TLDs.

get

/v1/partner/payment/options

Authorizations

Query parameters

tldstring

Top-level domain (TLD) of the name token to fetch payment options (comma separated list). Leave empty to fetch for all available TLDs.

Example: com

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/partner/payment/options' \
  --header 'Api-Key: YOUR_API_KEY'

200

401

403

200

{
  "options": [
    {
      "chainId": "1",
      "chainName": "Ethereum",
      "contractAddress": "0x46A7bEA3dBb87522834c8b24FA14D051893deE8a",
      "tokenAddress": "0x0000000000000000000000000000000000000000",
      "symbol": "BTC",
      "icon": "https://cdn.d3.app/assets/tokens/token_image_BTC.png",
      "price": "0.3983550997142373",
      "addressType": "EVM"
    }
  ]
}

Returns payment options for name tokens.

Create a partner order for name token purchase

Creates a new order for name token purchase. The response includes a payment voucher and details necessary to complete the purchase.

post

/v1/partner/order

Authorizations

Body

namesobject[]required

Array of names to mint, each including an SLD and TLD

paymentOptionsall ofrequired

The payment options for the transaction

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/partner/order' \
  --header 'Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"names":[{"sld":"example1","tld":"shib","autoRenew":false,"domainLength":1}],"paymentOptions":{"contractAddress":"0x46A7bEA3dBb87522834c8b24FA14D051893deE8a","tokenAddress":"0x0000000000000000000000000000000000000000","buyerAddress":"0x65d90DBa570408f8D512c91556d8E405acd99EE2"}}'

201

400

403

201

{
  "signature": "0x57235cf3bc5d305cc1dc4b040ae3b1dd34ade899ecc97d33e2167346c05f217348f80012d8081bdfaeed3f02a81e12483fdf12afd6715f5c5c1f322c390defc61c",
  "voucher": {
    "buyer": "0x0FB3F00e792F17B7D45611932ac72FcD4cdFfE6E",
    "token": "0x0000000000000000000000000000000000000000",
    "amount": "23295578965024017037",
    "voucherExpiration": 1727104758,
    "paymentId": "47cbbdaa-0a3c-4e80-94e9-139415e86fdd",
    "orderId": "3434-3675-5844-7264",
    "names": [
      {
        "registry": "0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8",
        "label": "example",
        "tld": "tst",
        "expirationTime": 1758585600,
        "owner": "0x0FB3F00e792F17B7D45611932ac72FcD4cdFfE6E",
        "renewal": false
      }
    ]
  }
}

The order has been successfully created.

Get name token metadata

Returns metadata and registration status of a name token.

get

/v1/partner/token/{sld}//{tld}

Authorizations

Path parameters

tldanyrequired

Top-level domain (TLD) of the name token.

Example: com

sldanyrequired

Second-level domain (SLD) of the name token.

Example: example

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/partner/token/{sld}/{tld}' \
  --header 'Api-Key: YOUR_API_KEY'

200

400

401

403

404

200

{
  "sld": "example",
  "tld": "com",
  "expirationDate": "2025-05-15T00:00:00.000Z",
  "owner": "0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532",
  "tokenId": "20719405654568256184282804044567699961418926341258048728655171573148113774124",
  "contractAddress": "0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8",
  "chainId": "1",
  "txHash": "2sXoUFPpgFXRKiAXYUWkwtAEQd46azUEFwoebcYQbN6s",
  "imageURL": "https://cdn.d3.app/tokens/1234567890abcdf123467890.png",
  "status": "registered"
}

Get name token metadata by token ID

Returns metadata of a name token by token ID.

get

/v1/partner/token/{chainId}//{contractAddress}//{tokenId}

Authorizations

Path parameters

chainIdstringrequired

Chain ID of the blockchain network.

Example: 1

contractAddressstringrequired

NFT Smart Contract address.

Example: 0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8

tokenIdstringrequired

Minted Token ID.

Example: 20719405654568256184282804044567699961418926341258048728655171573148113774124

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/partner/token/{chainId}/{contractAddress}/{tokenId}' \
  --header 'Api-Key: YOUR_API_KEY'

200

401

403

404

200

{
  "sld": "example",
  "tld": "com",
  "expirationDate": "2025-05-15T00:00:00.000Z",
  "owner": "0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532",
  "tokenId": "20719405654568256184282804044567699961418926341258048728655171573148113774124",
  "contractAddress": "0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8",
  "chainId": "1",
  "txHash": "2sXoUFPpgFXRKiAXYUWkwtAEQd46azUEFwoebcYQbN6s",
  "imageURL": "https://cdn.d3.app/tokens/1234567890abcdf123467890.png",
  "status": "registered"
}

Get name token metadata by multiple token IDs at once

Returns metadata of multiple name tokens by their token IDs.

post

/v1/partner/tokens/{chainId}//{contractAddress}

Authorizations

Path parameters

chainIdstringrequired

Chain ID of the blockchain network.

Example: 1

contractAddressstringrequired

NFT Smart Contract address.

Example: 0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8

Body

tokenIdsstring[]required

List of token ids to lookup for

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/partner/tokens/{chainId}/{contractAddress}' \
  --header 'Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"tokenIds":[null]}'

200

400

401

403

404

200

[
  {
    "sld": "example",
    "tld": "com",
    "expirationDate": "2025-05-15T00:00:00.000Z",
    "owner": "0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532",
    "tokenId": "20719405654568256184282804044567699961418926341258048728655171573148113774124",
    "contractAddress": "0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8",
    "chainId": "1",
    "txHash": "2sXoUFPpgFXRKiAXYUWkwtAEQd46azUEFwoebcYQbN6s",
    "imageURL": "https://cdn.d3.app/tokens/1234567890abcdf123467890.png",
    "status": "registered"
  }
]

Get name tokens for a wallet address

Returns registered name tokens for a wallet address

get

/v1/partner/tokens/{addressType}//{address}

Authorizations

Path parameters

addressanyrequired

Wallet address.

Example: 0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532

addressTypestring · enumrequired

Wallet address type.

Example: EVM

Options: EVM, SUI, NEAR, CASPER, TOKENPROOF

Query parameters

limitany · min: 1 · max: 100 · default: 25

Number of records to return for pagination.

Example: 100

skipany

Number of records to skip for pagination.

Example: 0

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/partner/tokens/{addressType}/{address}' \
  --header 'Api-Key: YOUR_API_KEY'

200

400

401

403

200

{
  "total": 42,
  "pageItems": [
    {
      "sld": "example",
      "tld": "com",
      "expirationDate": "2025-05-15T00:00:00.000Z",
      "tokenId": "20719405654568256184282804044567699961418926341258048728655171573148113774124",
      "contractAddress": "0x4F3775dfd49db0BBcd47eB6f45CEb6E6E9e15CD8",
      "chainId": "1"
    }
  ]
}