Skip to main content
POST
/
v2
/
farcaster
/
nft
/
mint
Mint NFT(s)
curl --request POST \
  --url https://api.neynar.com/v2/farcaster/nft/mint/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-wallet-id: <x-wallet-id>' \
  --data '
{
  "contract_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
  "network": "base",
  "recipients": [
    {
      "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
      "fid": "<unknown>",
      "quantity": 1
    }
  ],
  "async": false
}
'
{
  "transactions": [
    {
      "recipient": {
        "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
        "quantity": 2,
        "fid": 3,
        "tokens": [
          {
            "token_id": "<string>"
          }
        ]
      },
      "transaction_hash": "<string>",
      "receipt": {
        "block_number": "<string>",
        "gas_used": "<string>",
        "status": "<string>"
      }
    }
  ]
}

Authorizations

​
x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Headers

​
x-wallet-id
string
required

Wallet ID to use for transactions

Body

application/json

Request body for NFT minting operation.

​
contract_address
string
required

Ethereum address

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x5a927ac639636e534b678e81768ca19e2c6280b7"

​
network
enum<string>
required

Network to mint on.

Available options:
base,
optimism,
base-sepolia
Example:

"base"

​
recipients
object[]
required

List of recipients to mint to (1-200 recipients allowed).

Required array length: 1 - 200 elements

NFT mint recipient. Exactly one of "address" or "fid" must be set.

​
async
boolean

If true, returns immediately after sending the transaction.

Example:

false

Response

Success

Response for NFT minting operation.

​
transactions
object[]
required

Array of per-recipient mint results (success or error).

Successful mint transaction.