GET/relay-payload

Get relayer address and nonce

Fetches the relayer address and nonce for a specific user. Takes in the user's signer address and the type of nonce to retrieve.

Base URL: https://relayer-v2.polymarket.com
Auth: Public, no key
Rate limit: Not published
Limit applies to: n/a

Parameters

Name	In	Type	Required	Description
address	query	string	yes	User's signer address
type	query	string	yes	Type of nonce to retrieve

Example

curl -X GET "https://relayer-v2.polymarket.com/relay-payload?address=<address>&type=<type>"

Response fields

Field	Type	Description
address	string	Ethereum address (0x-prefixed, 40 hex chars)
nonce	string	Current nonce value

Responses

Status	Meaning
200	Relay payload retrieved successfully
400	Bad Request - Missing or invalid query parameters
500	Server Error

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.