Paper trading

Add / delete / test a webhook (API Pro and above)

act:"add" {url, events?} registers an https URL (max 3 per account) and returns its secret once. act:"delete" {id}. act:"test" {id} delivers a ping right now and returns the HTTP status your server answered. Deliveries: POST JSON {event, ts, hook_id, data} with headers X-MP-Event, X-MP-Delivery, X-MP-Timestamp and X-MP-Signature = sha256=HMAC_SHA256(secret, raw body). Retried 5 times with backoff; paused after 25 consecutive failures.

post/api/bot/v1/webhooks

Request

  • Base URL: https://marginpad.io
  • URL: https://marginpad.io/api/bot/v1/webhooks
  • Auth: API key in header X-API-Key

Request body

act'add' | 'delete' | 'test' required
urlstring

add: https URL on a public host

eventsstring[]

add: subset to receive; omit for all

idstring

delete / test: the webhook id

Response

ok

Changes

No recorded changes to this operation across all 1 revision of this API.