GET/transactions

Get recent transactions for a user

Gets the most recent transactions submitted to the Relayer, owned by a specific user. Authenticated using Builder API Keys or Relayer API Keys. **Builder API Key auth headers:** - `POLY_BUILDER_API_KEY` - `POLY_BUILDER_TIMESTAMP` - `POLY_BUILDER_PASSPHRASE` - `POLY_BUILDER_SIGNATURE` **Relayer API Key auth headers:** - `RELAYER_API_KEY` - `RELAYER_API_KEY_ADDRESS`

Base URL: https://relayer-v2.polymarket.com
Auth: Builder or Relayer API key headersPOLY_BUILDER_API_KEY, POLY_BUILDER_TIMESTAMP, POLY_BUILDER_PASSPHRASE, POLY_BUILDER_SIGNATURE, RELAYER_API_KEY, RELAYER_API_KEY_ADDRESSAuthenticated using Builder API Keys or Relayer API Keys.
Rate limit: Not published
Limit applies to: n/a

Parameters

Name	In	Type	Required	Description
POLY_BUILDER_API_KEY	header	string	no	Builder API key (when using Builder API Key auth)
POLY_BUILDER_TIMESTAMP	header	string	no	Unix timestamp (when using Builder API Key auth)
POLY_BUILDER_PASSPHRASE	header	string	no	Builder passphrase (when using Builder API Key auth)
POLY_BUILDER_SIGNATURE	header	string	no	HMAC-SHA256 signature (when using Builder API Key auth)
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)

Example

curl -X GET "https://relayer-v2.polymarket.com/transactions" \
  -H "POLY_BUILDER_API_KEY: $POLY_BUILDER_API_KEY" \
  -H "POLY_BUILDER_TIMESTAMP: $POLY_BUILDER_TIMESTAMP" \
  -H "POLY_BUILDER_PASSPHRASE: $POLY_BUILDER_PASSPHRASE" \
  -H "POLY_BUILDER_SIGNATURE: $POLY_BUILDER_SIGNATURE" \
  -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
transactionID	string	Unique identifier for the transaction
transactionHash	string	Onchain transaction hash (available once confirmed)
from	string	Ethereum address (0x-prefixed, 40 hex chars)
to	string	Ethereum address (0x-prefixed, 40 hex chars)
proxyAddress	string	Ethereum address (0x-prefixed, 40 hex chars)
data	string	Encoded transaction data (0x-prefixed hex string)
nonce	string	Transaction nonce
value	string	Transaction value
signature	string	Transaction signature (0x-prefixed hex string)
state	string	Current state of the transaction
type	string	Transaction type
owner	string	Ethereum address (0x-prefixed, 40 hex chars)
metadata	string	Transaction metadata
createdAt	string	Timestamp when the transaction was created
updatedAt	string	Timestamp when the transaction was last updated

Responses

Status	Meaning
200	Transactions retrieved successfully
401	Unauthorized - Invalid authentication
500	Server Error

Related endpoints

GET /transaction Relayer 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.