> ## Documentation Index > Fetch the complete documentation index at: https://api.synthesis.trade/docs/llms.txt > Use this file to discover all available pages before exploring further. # Data WebSocket > Connect to `wss://synthesis.trade/api/v1/data/ws` and send JSON messages over the socket. Subscription behavior: - Each subscribe request must include a `data_type` to select the feed. - An initial snapshot is returned, then live updates are streamed. ## OpenAPI ````yaml /openapi.json get /api/v1/data/ws openapi: 3.1.0 info: title: Synthesis API version: 1.0.0 description: Unified prediction market API for Polymarket and Kalshi. servers: - url: https://synthesis.trade security: [] tags: - name: Projects description: Create and manage project accounts, sessions, and account API keys. - name: Accounts description: >- Authenticate and manage account-level sessions, account API keys, and public account preferences. - name: Markets description: Unified market discovery and analytics across Polymarket and Kalshi. - name: Polymarket description: Polymarket market data, prices, orderbooks, trades, and holders endpoints. - name: Kalshi description: Kalshi market data, events, history, leaderboard, and profile endpoints. - name: Wallets description: Wallet management routes. Each wallet supports multiple chains. - name: Polygon description: >- Polygon wallet routes for balances, orders, minting, redemption, withdrawals, and swaps. - name: Polygon Copytrades description: Polymarket copytrade configuration and management for Polygon wallets. - name: Solana description: >- Solana wallet routes used for Kalshi balances, KYC, orders, redemption, and withdrawals. - name: News description: News endpoints with market and event matching. - name: WebSockets description: >- Real-time streaming endpoints for orderbooks, trades, balances, and live data feeds. paths: /api/v1/data/ws: get: tags: - WebSockets summary: Data WebSocket description: >- Connect to `wss://synthesis.trade/api/v1/data/ws` and send JSON messages over the socket. Subscription behavior: - Each subscribe request must include a `data_type` to select the feed. - An initial snapshot is returned, then live updates are streamed. operationId: data-ws requestBody: required: true content: application/json: schema: type: object required: - type - data_type properties: type: type: string description: >- WebSocket message type. Supported values: `subscribe` or `unsubscribe`. data_type: type: string description: >- Feed selector. Supported values: `news`, `prices`, `prices_chainlink`, `kalshi_prices`, `holders`, `holder_counts`, `sports`, `espn_match`, `espn_game_stats`, `signals`, `movers`, `elon_tweets`. params: type: object description: >- Feed-specific params. `news` - no `params` fields are read - use top-level `limit` and `offset` `prices` - `asset_id` or `symbol` - supported values: `btcusdt`, `ethusdt`, `xrpusdt`, `solusdt`, `bnbusdt`, `dogeusdt`, `hypeusdt` - optional `interval` - optional `open_price` - optional `ends_at` `prices_chainlink` - `asset_id` or `symbol` - supported values: `btc/usd`, `eth/usd`, `sol/usd`, `xrp/usd`, `bnb/usd`, `doge/usd`, `hype/usd` - optional `interval` - optional `open_price` - optional `ends_at` `kalshi_prices` - `symbol` only - supported values: `btc`, `eth`, `sol`, `xrp`, `doge`, `bnb`, `hype` - 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` `elon_tweets` - `event_id` limit: type: integer description: |- Top-level limit used by feeds that read it directly. Currently read by: - `news` - `holders` - `signals` offset: type: integer description: |- Top-level offset used by feeds that read it directly. Currently read by: - `news` - `holders` - `signals` responses: '101': description: WebSocket connection established content: application/json: examples: News Initial: summary: Initial news articles returned on news subscribe value: success: true response: data_type: news news: - news_id: c4d5e6f7-a8b9-0123-cdef-1234567890ab title: Bitcoin surges after ETF inflows accelerate description: ETF demand pushed spot BTC higher. url: https://example.com/news/bitcoin-etf source: Bloomberg matches: - market_id: KXBTC-25-T100000 venue: kalshi score: 0.88 event: series_id: KXBTC event_id: KXBTC-25 title: Bitcoin $100k slug: bitcoin-100k image: '' category: Crypto status: active active: true yes_price: '0.65' no_price: '0.35' volume: '500000' volume24hr: '25000' created_at: '2026-01-01T00:00:00' ends_at: '2026-12-31T23:59:59' created_at: '2026-01-01T09:31:00' published_at: '2026-01-01T09:30:00' News Update: summary: Live news article streamed after subscribe value: success: true response: news: news_id: d5e6f7a8-b9c0-1234-def0-234567890abc title: Fed holds rates steady source: Reuters description: The Federal Reserve kept rates unchanged. url: https://example.com/news/fed-rates matches: - market_id: '0xabc123' venue: polymarket score: 0.92 published_at: '2026-01-01T10:00:00' events: - venue: polymarket score: 0.92 event: event_id: 12345 title: Will the Fed cut rates? slug: will-the-fed-cut-rates description: >- This market resolves to Yes if the Federal Reserve announces a rate cut. image: https://example.com/fed.png tags: - economics - fed labels: - economics - macro neg_risk: false active: true liquidity: '2000000' volume: '8000000' volume24hr: '400000' volume1wk: '1200000' volume1mo: '3500000' volume1yr: '8000000' live: live: false ended: false created_at: '2026-01-01T00:00:00' updated_at: '2026-01-01T00:00:00' ends_at: '2026-12-31T23:59:59' Prices Initial: summary: Initial price history returned on prices subscribe value: success: true response: type: initial data_type: prices asset_id: btcusdt interval: 15M open_price: 97500 data: prices: - 97000 - 97250.5 - 97500 timestamps: - 1735689600000 - 1735690500000 - 1735691400000 current_price: 97500 price_history_len: 3 volatility: 0.012 fair_value: 'yes': 0.62 'no': 0.38 time_remaining: 0.75 Prices Update: summary: Live price tick streamed after prices subscribe value: success: true response: type: update data_type: prices symbol: btcusdt data: price: 97550 timestamp: 1735691500000 volatility: 0.012 fair_value: 'yes': 0.63 'no': 0.37 time_remaining: 0.74 Prices Chainlink Initial: summary: Initial Chainlink price history value: success: true response: type: initial data_type: prices_chainlink asset_id: btc/usd interval: 15M open_price: 97500 data: prices: - 97000 - 97250.5 - 97500 timestamps: - 1735689600000 - 1735690500000 - 1735691400000 current_price: 97500 price_history_len: 3 volatility: 0.012 fair_value: 'yes': 0.62 'no': 0.38 time_remaining: 0.75 Kalshi Prices Initial: summary: Initial Kalshi price history value: success: true response: type: initial data_type: kalshi_prices symbol: btc interval: 15M open_price: 97500 data: prices: - 97000 - 97250.5 - 97500 timestamps: - 1735689600000 - 1735690500000 - 1735691400000 current_price: 97500 price_history_len: 3 volatility: 0.012 fair_value: 'yes': 0.62 'no': 0.38 time_remaining: 0.75 Holders (Token) Initial: summary: Holders page for a single token_id value: success: true response: type: holders_page data_type: holders token_id: >- 21742633143463906290569050155826241533067272736897614950488156847949938836455 holders: - address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e' username: trader1 image: https://example.com/avatar.png shares: '1500.000000' avg_price: '0.450000' pnl: '225.000000' realized_pnl: '50.000000' holder_count: 1842 stats: total_pnl: '125000.000000' weighted_pnl: '68.250000' average_pnl: '67.860000' median_pnl: '12.500000' profitable_count: 1200 profitable_over_10k: 15 total_shares: '500000.000000' total_cash_value: '325000.000000' offset: 0 limit: 100 updated_at: '2026-01-01T00:00:00' Holders (Market) Initial: summary: Holders for a condition_id with left/right token sides value: success: true response: type: initial data_type: holders condition_id: >- 0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910 data: condition_id: >- 0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910 left: token_id: >- 21742633143463906290569050155826241533067272736897614950488156847949938836455 holders: - address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e' username: trader1 image: https://example.com/avatar.png shares: '1500.000000' avg_price: '0.450000' pnl: '225.000000' realized_pnl: '50.000000' holder_count: 1842 total_holders: 1842 stats: total_pnl: '125000.000000' weighted_pnl: '68.250000' average_pnl: '67.860000' median_pnl: '12.500000' profitable_count: 1200 profitable_over_10k: 15 total_shares: '500000.000000' total_cash_value: '325000.000000' right: token_id: >- 48388511015034828942276390714400011328125921609370079927799812281319682069004 holders: [] holder_count: 950 total_holders: 950 stats: total_pnl: '0.000000' weighted_pnl: '0.000000' average_pnl: '0.000000' median_pnl: '0.000000' profitable_count: 0 profitable_over_10k: 0 total_shares: '0.000000' total_cash_value: '0.000000' updated_at: '2026-01-01T00:00:00' Holders Delta: summary: >- Live holders delta streamed after subscribe (not WSResponse-wrapped) value: type: holders_delta data_type: holders condition_id: >- 0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910 token_id: >- 21742633143463906290569050155826241533067272736897614950488156847949938836455 version: 42 upserts: - address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e' username: trader1 image: https://example.com/avatar.png shares: '1600.000000' avg_price: '0.460000' realized_pnl: '50.000000' deletes: - '0x1111111111111111111111111111111111111111' holder_count: 1843 updated_at: '2026-01-01T00:01:00' Holder Counts Initial: summary: Batch holder counts for multiple condition_ids value: success: true response: type: initial data_type: holder_counts data: '0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910': left: 1842 right: 950 left_token_id: >- 21742633143463906290569050155826241533067272736897614950488156847949938836455 right_token_id: >- 48388511015034828942276390714400011328125921609370079927799812281319682069004 '0xabc123': left: 0 right: 0 updated_at: '2026-01-01T00:00:00' Sports Initial: summary: Live sports event data returned on sports subscribe value: success: true response: type: initial data_type: sports event: venue: polymarket event_id: '12345' title: Lakers vs Celtics slug: lakers-vs-celtics image: https://example.com/image.png live: live: true ended: false score: home: '98' away: '95' period: 4th clock: '2:30' Sports Update: summary: Live sports event update streamed after subscribe value: success: true response: type: update data_type: sports event: venue: polymarket event_id: '12345' title: Lakers vs Celtics slug: lakers-vs-celtics image: https://example.com/image.png live: live: true ended: false score: home: '100' away: '95' period: 4th clock: '1:45' ESPN Match Initial: summary: ESPN game match returned on espn_match subscribe value: success: true response: type: initial data_type: espn_match slug: lakers-celtics game: game_id: '401585601' sport: basketball league: nba period: 4th Quarter clock: '2:30' home_team: team_id: '13' name: Los Angeles Lakers abbreviation: LAL logo: https://a.espncdn.com/i/teamlogos/nba/500/lal.png score: '98' color: '552583' record: 30-15 away_team: team_id: '2' name: Boston Celtics abbreviation: BOS logo: https://a.espncdn.com/i/teamlogos/nba/500/bos.png score: '95' color: 007A33 record: 35-10 start_time: '2026-01-01T00:00:00' venue: Crypto.com Arena broadcast: ESPN status: in ESPN Game Stats Initial: summary: ESPN game stats returned on espn_game_stats subscribe value: success: true response: type: initial data_type: espn_game_stats game_id: '401585601' stats: leaders: - name: passingYards displayName: Passing Yards leaders: - displayValue: 285 YDS, 2 TD athlete: displayName: P. Mahomes headshot: https://a.espncdn.com/combiner/i?img=... team: abbreviation: KC boxscore: teams: - name: Kansas City Chiefs logo: https://a.espncdn.com/i/teamlogos/nfl/500/kc.png statistics: - label: Total Yards displayValue: '350' plays: - id: '1' text: P. Mahomes pass complete to T. Kelce for 15 yards clock: '2:30' period: '4' team: KC scoreValue: null situation: possession: KC down: 2 distance: 7 yardLine: 35 isRedZone: false linescores: - team: KC score: '21' periods: - '7' - '7' - '0' - '7' - team: SF score: '17' periods: - '3' - '7' - '7' - '0' Signals Initial: summary: Whale trade signals returned on signals subscribe value: success: true response: type: initial data_type: signals signals: - venue: polymarket tx_hash: >- 0xa1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2 token_id: >- 21742633143463906290569050155826241533067272736897614950488156847949938836455 side: BUY amount: '5000.000' shares: '7692.307' price: '0.650' trader: address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e' username: whale1 image: '' verified: true context: position_shares: '15000.000' position_avg_price: '0.500' position_pnl: '2250.000' total_volume: 1500000 total_pnl: 250000 trade_count: 5000 join_date: '2022-06-15' event: event_id: 12345 title: Will Bitcoin reach $100k by end of 2025? slug: will-bitcoin-reach-100k-by-end-of-2025 description: >- This market resolves to Yes if spot Bitcoin trades at or above $100,000 before 2025 ends. image: https://example.com/bitcoin.png tags: - crypto - bitcoin labels: - crypto - macro neg_risk: false active: true liquidity: '1500000' volume: '5000000' volume24hr: '250000' volume1wk: '900000' volume1mo: '2200000' volume1yr: '5000000' live: live: false ended: false created_at: '2026-01-01T00:00:00' updated_at: '2026-01-01T00:00:00' ends_at: '2026-12-31T23:59:59' market: event_id: 12345 condition_id: >- 0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910 question_id: '0xabcd' question: Will Bitcoin reach $100k? outcome: 'Yes' slug: will-bitcoin-reach-100k-yes description: >- Buy Yes if you think Bitcoin will trade at or above $100,000 before market expiry. image: https://example.com/bitcoin-market.png left_outcome: 'Yes' right_outcome: 'No' left_price: '0.65' right_price: '0.35' left_token_id: >- 21742633143463906290569050155826241533067272736897614950488156847949938836455 right_token_id: >- 48572956138472615938471625938471659384716593847165938471659384716593847165938 winner_token_id: '' active: true resolved: false fees: true decimals: 6 liquidity: '1500000' volume: '5000000' volume24hr: '250000' volume1wk: '900000' volume1mo: '2200000' volume1yr: '5000000' rewards: rewards: false created_at: '2026-01-01T00:00:00' updated_at: '2026-01-01T00:00:00' ends_at: '2026-12-31T23:59:59' created_at: '2026-01-01T00:00:00Z' has_more: true offset: 0 limit: 50 Signals Update: summary: Live whale trade signal streamed after subscribe value: success: true response: type: update data_type: signals signals: venue: polymarket tx_hash: >- 0xc3d4e5f6a7b8c3d4e5f6a7b8c3d4e5f6a7b8c3d4e5f6a7b8c3d4e5f6a7b8c3d4 token_id: >- 21742633143463906290569050155826241533067272736897614950488156847949938836455 side: SELL amount: '3000.000' shares: '4615.384' price: '0.650' trader: address: '0x1234567890abcdef1234567890abcdef12345678' username: whale2 image: '' verified: false context: position_shares: '0' position_avg_price: '0' position_pnl: '0' total_volume: 500000 total_pnl: 75000 trade_count: 1200 join_date: '2023-01-01' event: event_id: 12345 title: Will Bitcoin reach $100k by end of 2025? slug: will-bitcoin-reach-100k-by-end-of-2025 description: >- This market resolves to Yes if spot Bitcoin trades at or above $100,000 before 2025 ends. image: https://example.com/bitcoin.png tags: - crypto - bitcoin labels: - crypto - macro neg_risk: false active: true liquidity: '1500000' volume: '5000000' volume24hr: '250000' volume1wk: '900000' volume1mo: '2200000' volume1yr: '5000000' live: live: false ended: false created_at: '2026-01-01T00:00:00' updated_at: '2026-01-01T00:00:00' ends_at: '2026-12-31T23:59:59' market: event_id: 12345 condition_id: >- 0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910 question_id: '0xabcd' question: Will Bitcoin reach $100k? outcome: 'Yes' slug: will-bitcoin-reach-100k-yes description: >- Buy Yes if you think Bitcoin will trade at or above $100,000 before market expiry. image: https://example.com/bitcoin-market.png left_outcome: 'Yes' right_outcome: 'No' left_price: '0.65' right_price: '0.35' left_token_id: >- 21742633143463906290569050155826241533067272736897614950488156847949938836455 right_token_id: >- 48572956138472615938471625938471659384716593847165938471659384716593847165938 winner_token_id: '' active: true resolved: false fees: true decimals: 6 liquidity: '1500000' volume: '5000000' volume24hr: '250000' volume1wk: '900000' volume1mo: '2200000' volume1yr: '5000000' rewards: rewards: false created_at: '2026-01-01T00:00:00' updated_at: '2026-01-01T00:00:00' ends_at: '2026-12-31T23:59:59' created_at: '2026-01-01T00:01:00Z' Movers Initial: summary: Market movers returned on movers subscribe value: success: true response: type: initial data_type: movers venue: all direction: all timeframe: 1h movers: - venue: polymarket market_id: >- 0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910 token_id: >- 21742633143463906290569050155826241533067272736897614950488156847949938836455 title: Will Bitcoin reach $100k by end of 2025? slug: will-bitcoin-reach-100k-by-end-of-2025 image: https://example.com/image.png price: 0.65 price_old: 0.55 delta_pct: 18.18 delta_abs: 18.18 direction: up volume24hr: 125000 updated_at: '2026-01-01T00:00:00' Elon Tweets Initial: summary: Tweet count returned on elon_tweets subscribe value: success: true response: type: initial data_type: elon_tweets event_id: '12345' tweet_count: 42 Elon Tweets Update: summary: Live tweet count update streamed after subscribe value: success: true response: type: update data_type: elon_tweets event_id: '12345' tweet_count: 43 Unsubscribed: summary: Unsubscribe acknowledgment value: success: true response: Unsubscribed Error: summary: Error response value: success: false response: Invalid type. security: [] ````