Skip to main content
Data WebSocket
curl --request GET \
  --url https://synthesis.trade/api/v1/data/ws \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "data_type": "<string>",
  "params": {},
  "limit": 123,
  "offset": 123
}
'

Body

application/json
​
type
string
required

WebSocket message type. Supported values: subscribe or unsubscribe.

​
data_type
string
required

Feed selector. Supported values: news, prices, prices_chainlink, kalshi_prices, holders, holder_counts, sports, espn_match, espn_game_stats, signals, movers, fdv, elon_tweets.

​
params
object

Feed-specific params.

news

  • no params fields are read
  • use top-level limit and offset

prices

  • asset_id or symbol
  • optional interval
  • optional open_price
  • optional ends_at

prices_chainlink

  • asset_id or symbol
  • optional interval
  • optional open_price
  • optional ends_at

kalshi_prices

  • symbol only
  • supported values: btc, eth, doge
  • optional interval
  • optional open_price
  • optional ends_at

holders

  • token_id for token-holder page mode
  • or condition_id for market-holder mode
  • optional limit
  • optional offset
  • optional min_shares
  • optional sort with supported values shares, avg_price, pnl
  • optional order with supported values ASC, DESC

holder_counts

  • condition_ids array
  • maximum 2000 IDs

sports

  • event_id

espn_match

  • slug or title

espn_game_stats

  • game_id
  • optional sport
  • optional league

signals

  • no params fields are read
  • use top-level limit and offset

movers

  • optional venue with effective values all, polymarket, kalshi
  • optional direction with effective values all, up, down
  • optional timeframe with effective values 1h, 6h, 24h or 1d, 1w or 7d
  • optional min_volume
  • optional min_delta
  • optional limit

fdv

  • optional all boolean
  • optional tokens boolean
  • optional token_id
  • optional symbol
  • optional query
  • if no token_id, symbol, or query is supplied, the tokens list is returned
  • if a token is resolved, token, chart, and trades payloads are also returned for that token

elon_tweets

  • event_id
​
limit
integer

Top-level limit used by feeds that read it directly.

Currently read by:

  • news
  • holders
  • signals
​
offset
integer

Top-level offset used by feeds that read it directly.

Currently read by:

  • news
  • holders
  • signals

Response

101

WebSocket connection established