GET/relayer/api/keys

Get all relayer API keys

Returns all relayer API keys for the authenticated address. Auth allowed: Gamma auth or Relayer API key auth (`RELAYER_API_KEY` + `RELAYER_API_KEY_ADDRESS`).

Base URL: https://relayer-v2.polymarket.com
Auth: Builder or Relayer API key headersRELAYER_API_KEY, RELAYER_API_KEY_ADDRESSAuth allowed: Gamma auth or Relayer API key auth (`RELAYER_API_KEY` + `RELAYER_API_KEY_ADDRESS`).
Rate limit: Not published
Limit applies to: n/a

Parameters

Name	In	Type	Required	Description
RELAYER_API_KEY	header	string	no	Relayer API key (when using relayer API key auth)
RELAYER_API_KEY_ADDRESS	header	string	no	Address that owns the key (when using relayer API key auth). Must match the address that owns the key.

Example

curl -X GET "https://relayer-v2.polymarket.com/relayer/api/keys" \
  -H "RELAYER_API_KEY: $RELAYER_API_KEY" \
  -H "RELAYER_API_KEY_ADDRESS: $RELAYER_API_KEY_ADDRESS"

Returns a list of objects with these fields

Field	Type	Description
apiKey	string	The relayer API key
address	string	Ethereum address (0x-prefixed, 40 hex chars)
createdAt	string	Timestamp when the key was created
updatedAt	string	Timestamp when the key was last updated

Responses

Status	Meaning
200	API keys retrieved successfully. Returns an empty array if no keys exist for the authenticated address.
401	Unauthorized - Missing or invalid auth
403	Forbidden - Unsupported auth mechanism

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.