DEWELOPERZY
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"const response = await fetch('https://api.cryptohopper.com/v1/subscription', {
method: 'GET',
headers: {
"access-token": "YOUR_ACCESS_TOKEN"
}
});
const data = await response.json();import requests
response = requests.get(
"https://api.cryptohopper.com/v1/subscription",
headers={
"access-token": "YOUR_ACCESS_TOKEN"
},
)
data = response.json()$ch = curl_init('https://api.cryptohopper.com/v1/subscription');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'access-token: YOUR_ACCESS_TOKEN',
],
]);
$data = json_decode(curl_exec($ch), true);Parameters
Headers
| Name | Type | Required | Description |
|---|---|---|---|
access-token |
string | Required | The OAuth access token of the user. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
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
{
"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"
}
]
}