Skip to main content
POST
Create webhook

Body

application/json

Request body for creating a webhook

url
string
required

Destination URL for webhook deliveries (must be HTTPS)

event
enum<string>
required

Event to subscribe to

Available options:
trader_first_trade,
trader_new_market,
trader_whale_trade,
trader_new_trade,
trader_trade_event,
trader_global_pnl,
trader_market_pnl,
trader_category_pnl,
trader_position_resolved,
trader_exit_markers,
position_holder_metrics,
condition_holder_metrics,
event_holder_metrics,
condition_metrics,
event_metrics,
tag_metrics,
position_metrics,
position_liquidity,
market_liquidity,
event_liquidity,
market_volume_milestone,
event_volume_milestone,
position_volume_milestone,
market_volume_spike,
event_volume_spike,
position_volume_spike,
close_to_bond,
market_created,
asset_price_tick,
asset_price_window_update,
price_spike,
probability_spike,
oracle_events,
price_threshold,
market_resolved,
market_disputed
secret
string | null

Optional secret for HMAC signature verification

filters
null | object

Optional filters for event matching

description
string | null

Optional description/name

Response

Webhook created successfully

Webhook response (returned from API)

id
string
required

Unique webhook ID

url
string
required

Destination URL

event
enum<string>
required

Subscribed event

Available options:
trader_first_trade,
trader_new_market,
trader_whale_trade,
trader_new_trade,
trader_trade_event,
trader_global_pnl,
trader_market_pnl,
trader_category_pnl,
trader_position_resolved,
trader_exit_markers,
position_holder_metrics,
condition_holder_metrics,
event_holder_metrics,
condition_metrics,
event_metrics,
tag_metrics,
position_metrics,
position_liquidity,
market_liquidity,
event_liquidity,
market_volume_milestone,
event_volume_milestone,
position_volume_milestone,
market_volume_spike,
event_volume_spike,
position_volume_spike,
close_to_bond,
market_created,
asset_price_tick,
asset_price_window_update,
price_spike,
probability_spike,
oracle_events,
price_threshold,
market_resolved,
market_disputed
status
enum<string>
required

Current webhook status

Available options:
active,
paused,
disabled,
suspended
created_at
integer<int64>
required

Created timestamp (ms)

updated_at
integer<int64>
required

Updated timestamp (ms)

has_secret
boolean
required

Whether an HMAC secret is configured

filters
object

Active filters (omitted when no filters are set)

description
string | null

Description/name

credits_used_24h
integer<int64>

Credits consumed by this webhook in the last 24 hours

Last modified on July 13, 2026