Notifications

Endpoints to handle user notifications

get

Get notifications for a user with optional filtering and pagination

Query parameters

pagestringOptional

statusstring · enumOptionalPossible values:

Header parameters

x-wallet-addressstringRequired

Solana wallet address

x-signaturestringRequired

Signed message signature

x-signed-messagestringRequired

JSON string containing timestamp and action. Format: {"action": "string", "ts": "Unix timestamp (seconds)", "walletAddress": "string"}

Responses

200

Default Response

application/json

get

/notifications

HTTPcURLJavaScriptPython

GET /notifications HTTP/1.1
Host: 
x-wallet-address: text
x-signature: text
x-signed-message: text
Accept: */*

200

Default Response

{
  "success": true,
  "records": [
    {
      "notificationId": "text",
      "authorityId": "text",
      "title": "text",
      "body": "text",
      "type": "PRICE_ALERT",
      "status": "PENDING",
      "data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "sentAt": 1,
      "createdAt": 1
    }
  ],
  "meta": {
    "nextPage": "text"
  }
}

put

Update notification status (e.g., mark as read)

Path parameters

notificationIdstringRequired

Header parameters

x-wallet-addressstringRequired

Solana wallet address

x-signaturestringRequired

Signed message signature

x-signed-messagestringRequired

JSON string containing timestamp and action. Format: {"action": "string", "ts": "Unix timestamp (seconds)", "walletAddress": "string"}

Responses

200

Default Response

application/json

put

/notifications/{notificationId}/read

HTTPcURLJavaScriptPython

PUT /notifications/{notificationId}/read HTTP/1.1
Host: 
x-wallet-address: text
x-signature: text
x-signed-message: text
Accept: */*

200

Default Response

{
  "success": true
}

get

Get all registered devices for an account

Header parameters

x-wallet-addressstringRequired

Solana wallet address

x-signaturestringRequired

Signed message signature

x-signed-messagestringRequired

JSON string containing timestamp and action. Format: {"action": "string", "ts": "Unix timestamp (seconds)", "walletAddress": "string"}

Responses

200

Default Response

application/json

get

/notifications/devices

HTTPcURLJavaScriptPython

GET /notifications/devices HTTP/1.1
Host: 
x-wallet-address: text
x-signature: text
x-signed-message: text
Accept: */*

200

Default Response

{
  "success": true,
  "devices": [
    {
      "deviceId": "text",
      "token": "text",
      "platform": "ios"
    }
  ]
}

post

Register or update a device for push notifications

Header parameters

x-wallet-addressstringRequired

Solana wallet address

x-signaturestringRequired

Signed message signature

x-signed-messagestringRequired

JSON string containing timestamp and action. Format: {"action": "string", "ts": "Unix timestamp (seconds)", "walletAddress": "string"}

Body

application/json

deviceIdstringRequired

tokenstringOptional

platformstring · enumOptionalPossible values:

Responses

200

Default Response

application/json

post

/notifications/devices

HTTPcURLJavaScriptPython

POST /notifications/devices HTTP/1.1
Host: 
x-wallet-address: text
x-signature: text
x-signed-message: text
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "deviceId": "text",
  "token": "text",
  "platform": "ios"
}

200

Default Response

{
  "success": true,
  "device": {
    "deviceId": "text",
    "token": "text",
    "platform": "ios"
  }
}

delete

Delete a device registration

Path parameters

deviceIdstringRequired

Header parameters

x-wallet-addressstringRequired

Solana wallet address

x-signaturestringRequired

Signed message signature

x-signed-messagestringRequired

JSON string containing timestamp and action. Format: {"action": "string", "ts": "Unix timestamp (seconds)", "walletAddress": "string"}

Responses

200

Default Response

application/json

delete

/notifications/devices/{deviceId}

HTTPcURLJavaScriptPython

DELETE /notifications/devices/{deviceId} HTTP/1.1
Host: 
x-wallet-address: text
x-signature: text
x-signed-message: text
Accept: */*

200

Default Response

{
  "success": true
}