Wallet Trades
curl --request GET \
--url https://codex-api.nomos.trade/v1/wallets/{wallet}/trades \
--header 'Authorization: Bearer <token>'import requests
url = "https://codex-api.nomos.trade/v1/wallets/{wallet}/trades"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://codex-api.nomos.trade/v1/wallets/{wallet}/trades', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"wallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
"block": 94812405,
"complete": true,
"truncated": false,
"trades": [
{
"ts": 1790862117,
"block": 94812345,
"logIndex": 211,
"tx": "0x3f6a0c0d1d7f4b0a9e2c6b8f51a2e94d7c03b6a1e8f5d2c47a9b0e1f3c5d7e9a",
"wallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
"side": "BUY",
"asset": "85254962656314962064648492774584063365849461315753521676016468731069088672",
"conditionId": "0x8db33416a2d1ebde7438c80129e898f89a5deb3852ca64b37c4bf46513204409",
"outcomeIndex": 0,
"price": 0.231,
"size": 2000,
"usd": 462,
"fee": 0.92,
"feeUnit": "usd",
"role": "taker",
"counterparty": "0xe111180000d2663c0091e4f400237545b87b996b",
"exchange": "ctf-v2",
"market": {
"question": "US announces end of Iranian blockade by March 31, 2027?",
"slug": "us-announces-end-of-iranian-blockade-by-march-31-2027",
"eventSlug": "us-announces-end-of-iranian-blockade",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/example.png",
"category": "Politics",
"outcomes": [
"Yes",
"No"
],
"negRisk": false,
"outcome": "Yes"
}
}
],
"next": "1790862117,94812345,211"
}{
"error": "market must be a condition id"
}{
"error": "unknown or revoked API key"
}{
"error": "rate limit: 600 requests a minute; retry in 1 s"
}{
"error": "trade history is still loading"
}Wallets
Wallet Trades
Every trade the wallet made across all markets, newest first, each with its market. Or one market’s, with market. Or a search over its whole history, with q: one answer, newest first, before and market ignored.
GET
/
v1
/
wallets
/
{wallet}
/
trades
Wallet Trades
curl --request GET \
--url https://codex-api.nomos.trade/v1/wallets/{wallet}/trades \
--header 'Authorization: Bearer <token>'import requests
url = "https://codex-api.nomos.trade/v1/wallets/{wallet}/trades"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://codex-api.nomos.trade/v1/wallets/{wallet}/trades', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"wallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
"block": 94812405,
"complete": true,
"truncated": false,
"trades": [
{
"ts": 1790862117,
"block": 94812345,
"logIndex": 211,
"tx": "0x3f6a0c0d1d7f4b0a9e2c6b8f51a2e94d7c03b6a1e8f5d2c47a9b0e1f3c5d7e9a",
"wallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
"side": "BUY",
"asset": "85254962656314962064648492774584063365849461315753521676016468731069088672",
"conditionId": "0x8db33416a2d1ebde7438c80129e898f89a5deb3852ca64b37c4bf46513204409",
"outcomeIndex": 0,
"price": 0.231,
"size": 2000,
"usd": 462,
"fee": 0.92,
"feeUnit": "usd",
"role": "taker",
"counterparty": "0xe111180000d2663c0091e4f400237545b87b996b",
"exchange": "ctf-v2",
"market": {
"question": "US announces end of Iranian blockade by March 31, 2027?",
"slug": "us-announces-end-of-iranian-blockade-by-march-31-2027",
"eventSlug": "us-announces-end-of-iranian-blockade",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/example.png",
"category": "Politics",
"outcomes": [
"Yes",
"No"
],
"negRisk": false,
"outcome": "Yes"
}
}
],
"next": "1790862117,94812345,211"
}{
"error": "market must be a condition id"
}{
"error": "unknown or revoked API key"
}{
"error": "rate limit: 600 requests a minute; retry in 1 s"
}{
"error": "trade history is still loading"
}Authorizations
Your API key: codex_ and 48 hex characters.
Path Parameters
The wallet: 0x and 40 hex.
Pattern:
^0x[0-9a-fA-F]{40}$Query Parameters
Rows, 1 to 500. Out of range is clamped.
Required range:
1 <= x <= 500The previous page's next: ts,block,logIndex.
One market's trades only (echoed back).
Search: trades whose market question or outcome contains the text. Limit defaults to 300.
Response
OK
The trades table's cursor (can run a batch ahead of positions).
Over 20,000 markets: older trades are out of reach.
Search only.
Search only.
Search only: rows returned.
Search only: more matched.
Show child attributes
Show child attributes
Send it as before; null on a search.