Get your social notifications

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"

Parameters

Headers

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

Response

Example response (illustrative values)

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

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