Get Notifications

Retrieve user notifications and activity alerts

GET /notifications

Get Notifications

cURL

curl --request GET \
  --url https://frontend-api-v3.pump.fun/notifications

200

{
  "notifications": [
    {
      "id": "<string>",
      "type": "<string>",
      "title": "<string>",
      "message": "<string>",
      "createdAt": 123,
      "read": true,
      "metadata": {
        "userId": "<string>",
        "coinMint": "<string>",
        "amount": "<string>"
      }
    }
  ],
  "total": 123,
  "unreadCount": 123
}

Overview

The Notifications endpoint returns user-specific notifications about trades, mentions, follows, and other platform activity.

Authentication

This endpoint requires JWT authentication via the Authorization header:

Authorization: Bearer <your_token>

Endpoint

GET https://frontend-api-v3.pump.fun/notifications

Query Parameters

limit · number · required

Maximum number of notifications to return

offset · number · required

Number of notifications to skip for pagination

Response

notifications · array

Array of notification objects

Show Notification Object

id · string

Unique identifier for the notification

type · string

Type of notification (trade, mention, follow, like, etc.)

title · string

Notification title

message · string

Detailed notification message

createdAt · number

Unix timestamp when the notification was created

read · boolean

Whether the notification has been read

metadata · object

Additional context data specific to the notification type

Show Metadata

userId · string

Related user ID (for social notifications)

coinMint · string

Related coin mint address (for trade notifications)

amount · string

Transaction amount (for trade notifications)

total · number

Total number of notifications (for pagination)

unreadCount · number

Number of unread notifications

Notification Types

• trade - Trade execution notification
• mention - User mentioned you
• follow - New follower
• like - Someone liked your content
• reply - Reply to your comment
• coin_graduated - Coin you hold graduated to Raydium
• price_alert - Price threshold reached

Example Request

cURL

curl -X GET "https://frontend-api-v3.pump.fun/notifications?limit=20&offset=0" \
  -H "Authorization: Bearer <your_token>" \
  -H "Accept: application/json"

Use Cases

• Display user notification feed
• Build real-time notification systems
• Track unread notifications
• Send push notifications for important events
• Create activity logs and audit trails

Notes

• Replace <your_token> with your actual JWT token
• Notifications are user-specific based on the JWT token
• Use pagination to efficiently load notification history
• Check unreadCount to display notification badges
• Mark notifications as read through separate endpoint (if available)