Polymarket API reference / Relayer API
GET/transaction

Get a transaction by ID

Gets a transaction submitted to the Relayer. Takes in a required transaction ID as a query parameter. Poll this endpoint with the `transactionID` returned from `POST /submit` to retrieve the onchain `transactionHash` once the transaction has been broadcast.

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

Parameters

NameInTypeRequiredDescription
idquerystringyesTransaction ID

Example

curl -X GET "https://relayer-v2.polymarket.com/transaction?id=<id>"

Returns a list of objects with these fields

FieldTypeDescription
transactionIDstringUnique identifier for the transaction
transactionHashstringOnchain transaction hash (available once confirmed)
fromstringEthereum address (0x-prefixed, 40 hex chars)
tostringEthereum address (0x-prefixed, 40 hex chars)
proxyAddressstringEthereum address (0x-prefixed, 40 hex chars)
datastringEncoded transaction data (0x-prefixed hex string)
noncestringTransaction nonce
valuestringTransaction value
signaturestringTransaction signature (0x-prefixed hex string)
statestringCurrent state of the transaction
typestringTransaction type
ownerstringEthereum address (0x-prefixed, 40 hex chars)
metadatastringTransaction metadata
createdAtstringTimestamp when the transaction was created
updatedAtstringTimestamp when the transaction was last updated

Responses

StatusMeaning
200Transaction retrieved successfully
400Bad Request - Missing or invalid transaction ID
404Transaction not found
500Server Error

Related endpoints

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.