API reference - Siren Docs

Overview

Siren runs a Fastify API that powers the terminal, portfolio, and agent. All endpoints return JSON. Base URL: https://onsiren.xyz/api

Method	Path	Description
GET	`/api/markets`	List all markets with velocity and pricing data
GET	`/api/markets/search?q={query}`	Search markets by keyword
GET	`/api/markets/:ticker`	Get a single market by ticker
GET	`/api/markets/:ticker/activity`	Trade activity for a market
GET	`/api/markets/:ticker/candlesticks`	Price history candlesticks

Method	Path	Description
GET	`/api/signals`	Live signals (fast movers, volume spikes)
GET	`/api/sol-price`	Current SOL price

Method	Path	Description
GET	`/api/leaderboard`	Trader leaderboard rankings

All endpoints return JSON. Market endpoints include venue attribution so you can distinguish Kalshi markets from Polymarket markets.

The full OpenAPI specification:

View the Siren API specification file

These endpoints power the Siren terminal and portfolio. They are read endpoints.
Market data refreshes in real time from Kalshi and Polymarket.
The leaderboard updates as trades are executed.