GET https://api.cryptohopper.com/v1/subscription

Returns the user's subscriptions that have not ended yet, newest first.

OAuth scope: read About scopes

In this list plan_name holds the account holder's name instead of the plan name, and plan_description is missing. Get a subscription returns the plan name and description. exchange_only is all, or the only exchange the subscription can be used on.

Example request

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

Parameters

Headers

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

Query parameters

NameTypeRequiredDescription
unassigned string Optional Filter on bot assignment: 1 returns only subscriptions that are not assigned to a bot, 0 only subscriptions that are. Leave it out for all.

Response

Example response (illustrative values)

{
    "data": [
        {
            "subscription_id": "466000",
            "plan_id": "2",
            "payment_term": "month",
            "payment_method_id": "2",
            "start_time": "2026-09-01 10:15:00",
            "end_time": "2026-10-01 10:15:00",
            "subscription_status": "Active",
            "plan_name": "Jane Doe",
            "exchange_only": "all",
            "auto_renewal": "Yes"
        }
    ]
}

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