curl 'https://api.serialized.xyz/v1/webhook/price/tpsl/triggers?limit=2' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"id": "order-8812",
"name": "TP x2",
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"condition": { "gte": "0.000023" },
"unit": "usd",
"direction": "gte",
"status": "delivered",
"createdAt": 1792540800000,
"endedAt": 1792541401000,
"firedAt": 1792541400000,
"firedPriceNative": "0.000000121",
"firedPriceUsd": "0.0000230142",
"pool": "Hs97TCZeuYiJxooo3U73qEHXg3dKpRL4uYKYRryEK9CF",
"failReason": null,
"delivery": { "attempts": 1, "lastStatus": 200, "lastError": null, "deliveredAt": 1792541401000 }
},
{
"id": "order-8814",
"name": null,
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"condition": { "eq": "0.0042" },
"unit": "usd",
"direction": "gte",
"status": "active",
"createdAt": 1792541300000,
"endedAt": null,
"firedAt": null,
"firedPriceNative": null,
"firedPriceUsd": null,
"pool": null,
"failReason": null,
"delivery": null
}
],
"meta": {
"hasMore": true,
"nextCursor": "eyJhZnRlciI6Im9yZGVyLTg4MTQifQ"
}
}
Price Webhooks
List Price Triggers
The triggers of a price webhook, page by page: condition, status, the fired price and the delivery. Free.
GET
/
v1
/
webhook
/
price
/
{id}
/
triggers
curl 'https://api.serialized.xyz/v1/webhook/price/tpsl/triggers?limit=2' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"id": "order-8812",
"name": "TP x2",
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"condition": { "gte": "0.000023" },
"unit": "usd",
"direction": "gte",
"status": "delivered",
"createdAt": 1792540800000,
"endedAt": 1792541401000,
"firedAt": 1792541400000,
"firedPriceNative": "0.000000121",
"firedPriceUsd": "0.0000230142",
"pool": "Hs97TCZeuYiJxooo3U73qEHXg3dKpRL4uYKYRryEK9CF",
"failReason": null,
"delivery": { "attempts": 1, "lastStatus": 200, "lastError": null, "deliveredAt": 1792541401000 }
},
{
"id": "order-8814",
"name": null,
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"condition": { "eq": "0.0042" },
"unit": "usd",
"direction": "gte",
"status": "active",
"createdAt": 1792541300000,
"endedAt": null,
"firedAt": null,
"firedPriceNative": null,
"firedPriceUsd": null,
"pool": null,
"failReason": null,
"delivery": null
}
],
"meta": {
"hasMore": true,
"nextCursor": "eyJhZnRlciI6Im9yZGVyLTg4MTQifQ"
}
}
GET /v1/webhook/price/{id}/triggers · Free
The triggers of a price webhook by id, active and ended (an ended trigger is kept 30 days), with their condition and its unit (usd or native), status (statuses), and once fired the token’s price when it met the condition, in USD and in the native coin (firedPriceUsd, firedPriceNative; firedPriceUsd is null on a native level fired while the native coin’s USD price was not available), its market (pool), firedAt, failReason and the delivery (attempts, the last HTTP status and error, deliveredAt). A trigger that fired while your account could not pay keeps no firedPriceUsd, firedPriceNative or pool. Filter with status, or with ids (up to 100, comma-separated). Pages of up to 1,000 (100 by default): follow meta.nextCursor while meta.hasMore is true. Free.
curl 'https://api.serialized.xyz/v1/webhook/price/tpsl/triggers?limit=2' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"id": "order-8812",
"name": "TP x2",
"chain": "solana",
"address": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"condition": { "gte": "0.000023" },
"unit": "usd",
"direction": "gte",
"status": "delivered",
"createdAt": 1792540800000,
"endedAt": 1792541401000,
"firedAt": 1792541400000,
"firedPriceNative": "0.000000121",
"firedPriceUsd": "0.0000230142",
"pool": "Hs97TCZeuYiJxooo3U73qEHXg3dKpRL4uYKYRryEK9CF",
"failReason": null,
"delivery": { "attempts": 1, "lastStatus": 200, "lastError": null, "deliveredAt": 1792541401000 }
},
{
"id": "order-8814",
"name": null,
"chain": "evm:8453",
"address": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"condition": { "eq": "0.0042" },
"unit": "usd",
"direction": "gte",
"status": "active",
"createdAt": 1792541300000,
"endedAt": null,
"firedAt": null,
"firedPriceNative": null,
"firedPriceUsd": null,
"pool": null,
"failReason": null,
"delivery": null
}
],
"meta": {
"hasMore": true,
"nextCursor": "eyJhZnRlciI6Im9yZGVyLTg4MTQifQ"
}
}
Authorizations
Your raw API key (not needed on the demo server).
Path Parameters
The price webhook id: yours, or the wh_… id we generated.
Query Parameters
status
Option 1 · enum<string>Option 2 · enum<string>Option 3 · enum<string>Option 4 · enum<string>Option 5 · enum<string>
Only the triggers in this status: active, firing, delivered, failed or removed.
Available options:
active Up to 100 trigger ids, comma-separated.
Triggers per page, 1 to 1000. Default 100.
Required range:
1 <= x <= 1000meta.nextCursor of the previous page.
Response
200
Standard { data, meta } envelope.