Generate Claim Transaction

Return an encoded & serialized transaction to claim a Managed NFT

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

mintAddressstringRequired

Base-58 encoded string representing an on-chain address

Example: EBeLw5jEdrEgDe17BdKGW2MizzGxtxigEuAGvYC7VzDpPattern: ^[A-HJ-NP-Za-km-z1-9]*$

Body

application/json

claimerAddressstringOptional

payerAddressstringOptional

otpstringOptional

Responses

200

Encoded & serialized transaction to be signed by the claimer's wallet

application/json

transactionstringRequired

Encoded & serialized transaction to be signed by the claimer's wallet

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

post/v2/nfts/:mintAddress/claim

HTTPcURLJavaScriptPython

POST /v2/nfts/:mintAddress/claim HTTP/1.1
Host: api.underdogprotocol.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "claimerAddress": "text",
  "payerAddress": "text",
  "otp": "text"
}

{
  "transaction": "text"
}

Example

cURL

curl --location --request POST 'https://dev.underdogprotocol.com/v2/nfts/Dic1tC9yBhaDerQpV8ZBAsruBUKQsRWtCWysG965ADWi/claim' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "otp": "ddb287f5-f25b-4eb3-9abe-161c676b3f03",
    "claimerAddress": "EBeLw5jEdrEgDe17BdKGW2MizzGxtxigEuAGvYC7VzDp"
}'

JavaScript

const axios = require('axios');
let data = JSON.stringify({
  "otp": "ddb287f5-f25b-4eb3-9abe-161c676b3f03",
  "claimerAddress": "EBeLw5jEdrEgDe17BdKGW2MizzGxtxigEuAGvYC7VzDp"
});

let config = {
  method: 'post',
  url: 'https://dev.underdogprotocol.com/v2/nfts/Dic1tC9yBhaDerQpV8ZBAsruBUKQsRWtCWysG965ADWi/claim',
  headers: { 
    'Authorization': 'Bearer {token}', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Response

{
    "transaction": "ZUdfciTNnhrYbDaBnWjP1ZTQjNMM6KBvW2kCk5DXW9iVY6XSEkqgueroVFcyLNcj2oHW6ZoYWT3FbFRRZLAn7tepKvkiRtD8Fj1reHiFmKgc45LfjCcC6n9us1Ere2CMVkPq4SYrgPhpQR2sj7MX1vajJKrWsJSryJbUnZXZdrTFk5XKBtBHv7mj1Wss1MhvMGEBBgdyweG5zTfA8sfNrgPBmqPXbKCJWGUj5hpxAAYREo2EG5vQJkR11QGvDkzQfTShdX11Hx58fjj66KUJe6uLwa5hrU3aX6CPnorLmnAwdP7oR9NAX8fyhNxp4Ju6rMJ8vVEhkLeWtJu4aYbfUHgoAXUKpJkAgH32K51FJFCvkSCwazc8P9sNMBgUFGnGdNGxxNRizQbX6KFAon2skeswf9qUBbmL5yjfux6AQwyhdr8yE3GoXDr1TXEyynQfSoPmMACxqMXQPJgbH4vzUgZsYdVG55iVbN7GmbQwMrHZJo4AVm8cbL11JRvpZMeqQerFww5kLpwJ2VC9gzU1CbA4qXpQ19zWC1TMDqCNm1N9P7kNBXcpu9n4pp5PJLpDaqutXJrMLjSP5baeTffPkhwZEg5SDLKE3NexJtyFA58TDRmMctz5FhdJ8Xi459MhvVrXkbN1ffX5MmX6wv8ZNX1ysrs6HGcbSea6B1UKw689ks6BKNzfagGZ54GZi8MFjHhTcrqjDi1EMbtLbNSL89arPiEPYUo2gXFe9FRLWuvCQegtMS3gGFjbr7mY9tmJn97p9kGCYT5oPXd8QHooS9vUmsGPraPtbW41qC4x6fyYNDR8tP2vZaetVaiLfEd64jE2DNjDNugDyiMSQF8h8DhECCmB9o4tUJVqGmf5T1emBxuL9c4GntHYYzByueh6tyHqrSiATQtrLigxyj1fFMVHBnaQaSpg3tfQSHxq2Kxro7DB8AUNyWsKvU169C2nTP8q2x88uzr9VfwKcgCWNyRjKJmYJM5CPGhP55bBS5GcVeTiSUZh4Vaq4LcBdxjEJQPB6TLLvjAaanEvycw55GbbmLcJDszfrNZHGh2P65RoswMBoVKQkFxT35ZatrQHrqCCnwmpWskU7fcWp4qp8T4aaozWpRxECNWNpeQbkCwEDdX69cL4i6i6ag34VAWM8FJ6sB251cDjvaQcFAMkTnCzC3s5mReovVu9CDDGPtbzpFXRQVP7c3KD5rsPLpzYs36zo7iChrdA7nmCTDiktiZKGJZ7FUKWpzebwC7RJKqyNNmq467u4VCEGuePm5CRjvfaHVnfjRdmXyAS8T1kTiJRmPVyF2xMugB3BzQGo4eQitRsBsBULnHdUCRC33qFDgNNbMSsggifp5vvQz7it1jgYY8ortgd9H6Z6czNByrxwNYJJLGbRp8w6PWr2aJ5jpkPU6M6DMsjX97GLsY6R9b3EMJm3SDMfhCnvmULepuem4cVKHdQ1dHkdAXukQLZ586pdETFp6xYjxAyu"
}