curl -X POST 'https://api.serialized.xyz/v1/webhook/price/tpsl/endpoint' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"callbackUrl":"https://example.com/hooks/price-v2","rotate":true}'
{
"data": {
"id": "tpsl",
"name": "Orders",
"callbackUrl": "https://example.com/hooks/price-v2",
"updatedAt": 1792541500000,
"secret": "whsec_Q8mV3pXt7nB1cLa9rJd0yKe4sWfZ2uHg"
}
}
Price Webhooks
Update a Price Webhook
Change the URL, the secret or the name of a price webhook, or rotate its secret. Free.
POST
/
v1
/
webhook
/
price
/
{id}
/
endpoint
curl -X POST 'https://api.serialized.xyz/v1/webhook/price/tpsl/endpoint' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"callbackUrl":"https://example.com/hooks/price-v2","rotate":true}'
{
"data": {
"id": "tpsl",
"name": "Orders",
"callbackUrl": "https://example.com/hooks/price-v2",
"updatedAt": 1792541500000,
"secret": "whsec_Q8mV3pXt7nB1cLa9rJd0yKe4sWfZ2uHg"
}
}
POST /v1/webhook/price/{id}/endpoint · Free
Changes the callbackUrl, the secret or the name of a price webhook (name: null removes it), at least one of them. rotate: true generates a new secret and returns it in this response only (not with secret). A new URL is checked like at creation. The next attempts of every delivery use the new URL and secret. Free.
curl -X POST 'https://api.serialized.xyz/v1/webhook/price/tpsl/endpoint' \
-H 'Authorization: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"callbackUrl":"https://example.com/hooks/price-v2","rotate":true}'
{
"data": {
"id": "tpsl",
"name": "Orders",
"callbackUrl": "https://example.com/hooks/price-v2",
"updatedAt": 1792541500000,
"secret": "whsec_Q8mV3pXt7nB1cLa9rJd0yKe4sWfZ2uHg"
}
}
Authorizations
Your raw API key (not needed on the demo server).
Path Parameters
The price webhook id: yours, or the wh_… id we generated.
Body
application/json
A new callback URL, same rules as at creation.
A new secret of your own: 16 to 256 printable ASCII characters without spaces.
true: we generate a new secret and return it once. Not with secret.
Available options:
true A new name (1 to 128 characters), or null to remove it.
Response
200
Standard { data, meta } envelope.