GET https://api.cryptohopper.com/v1/platform/promobar

Returns the promo bar shown on the Cryptohopper website for a language: text, button text and link, and its dates. Falls back to the default promo bar when the language has none.

No access token needed. The promo bar is returned whatever its start_date, end_date and status, so check those yourself. Show promo_text and button_text as plain text, not HTML.

Example request

curl "https://api.cryptohopper.com/v1/platform/promobar" \
  -H "access-token: YOUR_ACCESS_TOKEN"

Parameters

Headers

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

Query parameters

NameTypeRequiredDescription
lang string Optional Short language code, for example nl or de. Without it the Accept-Language header is used. English and unknown codes return the default promo bar.

Response

Example response (illustrative values)

{
    "data": {
        "id": "3",
        "lang": "*",
        "promo_id": "autumn-sale",
        "promo_text": "Autumn sale: 30% off all yearly plans",
        "button_link": "https://www.cryptohopper.com/pricing",
        "button_text": "See plans",
        "start_date": "2026-09-20 00:00:00",
        "end_date": "2026-09-30 23:59:59",
        "status": "1"
    }
}

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