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"}'

Parameters

Headers

NameTypeRequiredDescription
access-token string Required The OAuth access token of the user.

Response

Example response (illustrative values)

{
    "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"
    }
}

Status codes: 200. Errors return JSON with status, error and message. See How the API works for response codes and rate limits.