curl --request POST \
  --url https://testnet.walletkit.com/nfts/mint \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "network": "Ethereum",
  "contract_address": "<string>",
  "recipient": "<string>",
  "metadata": {
    "name": "<string>",
    "description": "<string>",
    "image": "<string>"
  },
  "uri": "<string>",
  "developer_secret": "<string>",
  "user_pin": "<string>"
}'
{
  "transaction_id": "<string>",
  "network": "Ethereum",
  "status": "<string>"
}

Headers

X-WalletKit-Project-ID
string
required

Your WalletKit Project ID can be found on the API Keys page in the WalletKit Dashboard.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
network
enum<string>
required
Available options:
Ethereum,
Polygon,
Base,
Avalanche,
Polkadot,
Vara
contract_address
string
required

address of the NFT collection smart contract to mint from.

recipient
string | null

wallet address where the NFT should be delivered. defaults to the sender's address.

metadata
object

Metadata JSON object.

uri
string | null

uri the the nft metadata.json, schema define in https://eips.ethereum.org/EIPS/eip-721#specification. Use the metadata field instead if the metadata.json doesn't exist and needs to be created and hosted.

developer_secret
string | null

On testnet, the developer_secret is always "testnet-secret". On mainnet, the developer_secret is set by the developer during account activation.

user_pin
string | null

A 6-digit numeric pin that is only known to the user, set during wallet creation. This pin is required to sign transactions from this wallet.

Response

200
application/json
transaction_id
string
required
network
enum<string>
required
Available options:
Ethereum,
Polygon,
Base,
Avalanche,
Polkadot,
Vara
status
string
required