List my notifications
curl --request GET \
--url https://mcp.echozero.app/api/v1/notifications \
--header 'x-api-key: <api-key>' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>'import requests
url = "https://mcp.echozero.app/api/v1/notifications"
headers = {
"x-signature": "<x-signature>",
"x-timestamp": "<x-timestamp>",
"x-api-key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
'x-api-key': '<api-key>'
}
};
fetch('https://mcp.echozero.app/api/v1/notifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
'x-api-key': '<api-key>'
}
};
fetch('https://mcp.echozero.app/api/v1/notifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mcp.echozero.app/api/v1/notifications"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-signature", "<x-signature>")
req.Header.Add("x-timestamp", "<x-timestamp>")
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"success": true,
"data": {
"items": [
{
"id": "<string>",
"title": "<string>",
"body": "<string>",
"sendsAt": "2023-11-07T05:31:56Z",
"markAsRead": true,
"notificationTokens": [
"<string>"
],
"user": "<string>",
"wsProcessedAt": "2023-11-07T05:31:56Z",
"fbProcessedAt": "2023-11-07T05:31:56Z",
"webPushLink": "<string>",
"androidActionClick": "<string>",
"iosCategory": "<string>",
"imageUrl": "<string>",
"template": "<string>",
"event": "<string>",
"type": "NEW_PICKS",
"customNotification": "<string>",
"isClicked": true,
"fbTitle": "<string>",
"fbBody": "<string>"
}
],
"pagination": {
"total": 123,
"limit": 123,
"page": 123,
"totalPages": 123,
"hasNextPage": true,
"hasPreviousPage": true
},
"totalUnreadCount": 123
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}Notification
List my notifications
Mirrors GraphQL myNotifications. Returns items + pagination (see PaginatedResponse) plus totalUnreadCount (global unread, not page-only).
GET
/
api
/
v1
/
notifications
List my notifications
curl --request GET \
--url https://mcp.echozero.app/api/v1/notifications \
--header 'x-api-key: <api-key>' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>'import requests
url = "https://mcp.echozero.app/api/v1/notifications"
headers = {
"x-signature": "<x-signature>",
"x-timestamp": "<x-timestamp>",
"x-api-key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
'x-api-key': '<api-key>'
}
};
fetch('https://mcp.echozero.app/api/v1/notifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'GET',
headers: {
'x-signature': '<x-signature>',
'x-timestamp': '<x-timestamp>',
'x-api-key': '<api-key>'
}
};
fetch('https://mcp.echozero.app/api/v1/notifications', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mcp.echozero.app/api/v1/notifications"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-signature", "<x-signature>")
req.Header.Add("x-timestamp", "<x-timestamp>")
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"success": true,
"data": {
"items": [
{
"id": "<string>",
"title": "<string>",
"body": "<string>",
"sendsAt": "2023-11-07T05:31:56Z",
"markAsRead": true,
"notificationTokens": [
"<string>"
],
"user": "<string>",
"wsProcessedAt": "2023-11-07T05:31:56Z",
"fbProcessedAt": "2023-11-07T05:31:56Z",
"webPushLink": "<string>",
"androidActionClick": "<string>",
"iosCategory": "<string>",
"imageUrl": "<string>",
"template": "<string>",
"event": "<string>",
"type": "NEW_PICKS",
"customNotification": "<string>",
"isClicked": true,
"fbTitle": "<string>",
"fbBody": "<string>"
}
],
"pagination": {
"total": 123,
"limit": 123,
"page": 123,
"totalPages": 123,
"hasNextPage": true,
"hasPreviousPage": true
},
"totalUnreadCount": 123
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Resource not found"
}
}Authorizations
Headers
Required for API-key authenticated requests. HMAC-SHA256(secretKey, timestamp + METHOD + path + body) as lowercase hex. Omit only for JWT/OAuth session tokens or public routes.
Required with x-signature. Epoch milliseconds; rejected if drift exceeds 5 minutes. Omit only for JWT/OAuth session tokens or public routes.
Query Parameters
Page size (max 100)
Available options:
ASC, DESC Available options:
_id, sendsAt, markAsRead Search in title and body (same as GraphQL filter.query)
Comma-separated NotificationType values (e.g. NEW_PICKS,WALLET_UPDATE)
true = unread only, false = read only, omit = all