> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onsiren.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Siren API endpoints for markets, signals, prices, and leaderboard data.

## Overview

Siren runs a Fastify API that powers the terminal, portfolio, and agent. All endpoints return JSON.

Base URL: `https://onsiren.xyz/api`

***

## Endpoints

### Markets

| 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                      |

### Signals and prices

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

### Leaderboard

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

***

## Response format

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

***

## OpenAPI spec

The full OpenAPI specification:

<Card title="Siren OpenAPI spec" icon="code" href="/api-reference/openapi.json">
  View the Siren API specification file
</Card>

***

## Notes

* 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.