POST
https://api.cryptohopper.com/v1/market/giftcards/validate
Returns the details of the gift card behind a code without redeeming it.
Only available to Cryptohopper's own apps; other apps get a 403 error. The code must be exactly 64 characters and belong to a paid, unexpired gift card. Code checks are throttled per user: one attempt per 10 seconds, and further checks fail for an hour after 11 attempts. giftcard_value is always null here.
Example request
curl -X POST "https://api.cryptohopper.com/v1/market/giftcards/validate" \
-H "access-token: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"giftcard_code":"Xk3P9qLm2Vr7Tz8Nw4Hs6Jd1Fb5Gc0Ya9Qe2Ru7Io4Pl3Mk8Nj6Bh1Vg5Cf0Dx7S"}'
const response = await fetch('https://api.cryptohopper.com/v1/market/giftcards/validate', {
method: 'POST',
headers: {
"access-token": "YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"giftcard_code": "Xk3P9qLm2Vr7Tz8Nw4Hs6Jd1Fb5Gc0Ya9Qe2Ru7Io4Pl3Mk8Nj6Bh1Vg5Cf0Dx7S"
})
});
const data = await response.json();
import requests
response = requests.post(
"https://api.cryptohopper.com/v1/market/giftcards/validate",
headers={
"access-token": "YOUR_ACCESS_TOKEN"
},
json={
"giftcard_code": "Xk3P9qLm2Vr7Tz8Nw4Hs6Jd1Fb5Gc0Ya9Qe2Ru7Io4Pl3Mk8Nj6Bh1Vg5Cf0Dx7S"
},
)
data = response.json()
$ch = curl_init('https://api.cryptohopper.com/v1/market/giftcards/validate');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'access-token: YOUR_ACCESS_TOKEN',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'giftcard_code' => 'Xk3P9qLm2Vr7Tz8Nw4Hs6Jd1Fb5Gc0Ya9Qe2Ru7Io4Pl3Mk8Nj6Bh1Vg5Cf0Dx7S',
]),
]);
$data = json_decode(curl_exec($ch), true);
Parameters
Headers
| Name | Type | Required | Description |
|---|---|---|---|
access-token |
string | Required | The OAuth access token of the user. |
Response
{
"data": {
"id": "8841",
"giftcard_name": "Cryptohopper credits 50",
"giftcard_id": "12",
"giftcard_type": "credits",
"giftcard_value": null,
"plan_id": "0",
"payment_term": "month",
"marketplace_id": "0",
"currency": "USD",
"price": "50.00",
"expire_date": "2027-09-20 12:00:00",
"created": "2026-09-20 12:00:00",
"updated": "2026-09-20 12:05:00"
}
}