Skip to main content
POST
/
v1
/
project-wallet
/
drops
/
claim
Claim NFT from a drop using server wallet
curl --request POST \
  --url https://api.lootexplus.com/v1/project-wallet/drops/claim \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chainId": 1868,
  "contractAddress": "0x0eC8705Ca1071f467cB4bAEb548Af2aeaF5426fd",
  "recipientAddress": "",
  "quantity": 1,
  "projectId": "123",
  "overrideMetadata": [
    {
      "name": "Cool NFT #1",
      "description": "This is a really cool NFT",
      "image": "https://example.com/image.png",
      "animationUrl": "https://example.com/animation.mp4",
      "externalUrl": "https://example.com",
      "attributes": [
        {
          "trait_type": "Background",
          "value": "Blue",
          "display_type": "string"
        }
      ],
      "properties": {
        "category": "art"
      }
    }
  ]
}
'
{
  "assets": [
    {
      "chainId": 1868,
      "contractAddress": "0xda365ed7e15c1fdc74a9bef7ff558b33892f7534",
      "tokenId": "2",
      "name": "Slowpoke #7397",
      "description": "Incredibly slow and dopey. It takes 5 seconds for it to feel pain when under attack.",
      "imageUrl": "https://raw.githubusercontent.com/PokeAPI/sprites/master/sprites/pokemon/other/official-artwork/79.png",
      "animationUrl": "",
      "tokenUri": "https://api.lootexplus.com/v1/metadata/d999b43b-be34-40c8-98fe-bcdb5fea8de9/0",
      "schema": "ERC721",
      "bestListing": null,
      "collection": {
        "id": "f98bcb27-d77a-4786-848f-7357aab8e704",
        "slug": "soneium:0xda365ed7e15c1fdc74a9bef7ff558b33892f7534",
        "chainId": 1868,
        "contractAddress": "0xda365ed7e15c1fdc74a9bef7ff558b33892f7534",
        "name": "My NFT Drop",
        "isVerified": false
      }
    }
  ],
  "transactions": [
    {
      "id": "abb2aec3-0b51-43e2-9cf8-3b4ff37263a5",
      "jobId": "3edff414918b5851d5676ea9",
      "status": "pending",
      "projectId": "p-2e48091c5b40d0d03a564e5a",
      "transactionHash": "0xcf8b0157b6b2f6cc9b6d8e27e71985f15475ab826308cbbb2fb71ac23700fddc",
      "chainId": 1868,
      "from": "0x50A1eD7DEb09508771288BcEa72143436ffCF7Fb",
      "to": "0xda365ed7e15c1fdc74a9bef7ff558b33892f7534",
      "value": "0",
      "data": "0x84bb1e420000000000000000000000007d878a527e86321aecd80a493e584117a907a0ab0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000000000000000000000000000000000000000000180000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000003e80000000000000000000000000000000000000000000000000000000000000000000000000000000000000000eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "gasUsed": null,
      "gasPrice": null,
      "totalGasFee": null,
      "metadata": null,
      "createdAt": "2025-08-15T09:20:26.869Z",
      "updatedAt": "2025-08-15T09:20:26.869Z"
    }
  ]
}

Authorizations

Authorization
string
header
required

Secret key for authentication

Body

application/json

Claim drop data

chainId
number
default:1868
required

Chain ID

Example:

1868

contractAddress
string
required

Drop contract address

Example:

"0x0eC8705Ca1071f467cB4bAEb548Af2aeaF5426fd"

recipientAddress
string
required

Recipient wallet address

Example:

""

quantity
number
default:1
required

Quantity

Example:

1

projectId
string

Project ID

Example:

"123"

overrideMetadata
object[]

Override metadata for each token minted

Response

201 - application/json

NFT claimed successfully

assets
object[]
required

The assets that were claimed from the drop

transactions
object[]
required

The transactions that were sent to claim the drop