GET
https://api.cryptohopper.com/v1/social/notifications
Returns the social notifications of the last 14 days for your profile, newest first: new followers, likes on your posts and comments, tournament messages and moderation notices. Reading them also clears your unread notification counter.
OAuth scope:
read About scopes
notification_type is follow, like, tournament or blockpost. For like and blockpost, notification_data.post holds the post or comment involved. start and end are the Unix timestamps of the window that was read.
Example request
curl "https://api.cryptohopper.com/v1/social/notifications" \
-H "access-token: YOUR_ACCESS_TOKEN"
const response = await fetch('https://api.cryptohopper.com/v1/social/notifications', {
method: 'GET',
headers: {
"access-token": "YOUR_ACCESS_TOKEN"
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api.cryptohopper.com/v1/social/notifications",
headers={
"access-token": "YOUR_ACCESS_TOKEN"
},
)
data = response.json()
$ch = curl_init('https://api.cryptohopper.com/v1/social/notifications');
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. |
Response
{
"data": {
"items": [
{
"date": "2026-09-24T14:02:11Z",
"date_time": 1790258531,
"notification_type": "follow",
"notification_data": {
"profile_id": "5678",
"profile": {
"profile_name": "Hodl Henk",
"profile_alias": "hodl-henk",
"profile_image": "https://cdn.example.com/images/social/uploads/avatar_4567.jpg",
"verified": "0",
"profile_link": "/social/profile/hodl-henk"
},
"following": null
},
"notification_image": "<i class=\"fa fa-user-plus fa-3x text-success\"></i>"
}
],
"start": 1789106400,
"end": 1790316000
}
}