GET/notifications

Get notifications

Retrieves all unread notifications for the authenticated user. Notification types include: - Order cancellation - Order fill (taker or maker) - Market registered - Market resolved - Reward payout - Child comment created

Base URL: https://clob.polymarket.com
Auth: L2 API credentials (key, secret, passphrase)POLY_API_KEY, POLY_ADDRESS, POLY_SIGNATURE, POLY_PASSPHRASE, POLY_TIMESTAMP
Rate limit: 125 req / 10s (12.5 per second)
Limit applies to: /notifications

Parameters

Name	In	Type	Required	Description
signature_type	query	integer	yes	Signature type for address derivation: - 0: EOA - 1: POLY_PROXY - 2: POLY_GNOSIS_SAFE

Example

curl -X GET "https://clob.polymarket.com/notifications?signature_type=<signature_type>" \
  -H "POLY_API_KEY: $POLY_API_KEY" \
  -H "POLY_ADDRESS: $POLY_ADDRESS" \
  -H "POLY_SIGNATURE: $POLY_SIGNATURE" \
  -H "POLY_PASSPHRASE: $POLY_PASSPHRASE" \
  -H "POLY_TIMESTAMP: $POLY_TIMESTAMP"

L2 requests are signed with HMAC-SHA256 using your API secret, and the timestamp is part of the signature, so keep the machine's clock accurate. A missing credential or a stale signature both come back as Unauthorized/Invalid api key. The Python SDK signs for you.

Returns a list of objects with these fields

Field	Type	Description
id	integer	Unique identifier for the notification
owner	string	API key of the notification owner (empty for broadcast notifications)
type	integer	Type of notification: - 1: Order cancellation - 2: Order fill - 3: Market registered - 4: Market resolved - 5: Reward payout - 6: Child comment created
payload	object	Dynamic payload containing notification-specific data
timestamp	integer	Unix timestamp when the notification was created

Responses

Status	Meaning
200	Successfully retrieved notifications
400	Bad request - Invalid signature_type
401	Unauthorized - Invalid API key or authentication failed
500	Internal server error

Related endpoints

DELETE /notifications CLOB API

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.