# Endpoints

Quick reference for all Turbine API endpoints.

Base URL:

```
https://api.turbinefi.com/api/v1
```

***

## Authentication (authentication.md)

| Method | Path        | Description                               | Auth |
| ------ | ----------- | ----------------------------------------- | ---- |
| POST   | `/api-keys` | Register a new API key (wallet signature) | No   |

***

## Markets (markets.md)

| Method | Path                   | Description                  | Auth |
| ------ | ---------------------- | ---------------------------- | ---- |
| GET    | `/markets`             | List all markets             | No   |
| GET    | `/stats/{marketId}`    | Get market statistics        | No   |
| GET    | `/holders/{marketId}`  | Get top token holders        | No   |
| GET    | `/activity/{marketId}` | Get market activity feed     | No   |
| GET    | `/platform/stats`      | Get platform-wide statistics | No   |
| GET    | `/comments/{marketId}` | Get market comments          | No   |
| POST   | `/comments/{marketId}` | Post a comment               | Yes  |

***

## Orderbook (orderbook.md)

| Method | Path                    | Description         | Auth |
| ------ | ----------------------- | ------------------- | ---- |
| GET    | `/orderbook/{marketId}` | Get orderbook depth | No   |

***

## Orders (orders.md)

| Method | Path                      | Description                      | Auth |
| ------ | ------------------------- | -------------------------------- | ---- |
| POST   | `/orders`                 | Submit a signed order            | Yes  |
| GET    | `/orders`                 | Get open orders for a trader     | Yes  |
| DELETE | `/orders/{hash}`          | Cancel an open order             | Yes  |
| GET    | `/users/{address}/orders` | Get all orders across markets    | Yes  |
| GET    | `/failed-trades`          | Get failed trade settlements     | No   |
| GET    | `/pending-trades`         | Get trades awaiting confirmation | No   |
| GET    | `/settlements/{txHash}`   | Look up settlement status        | No   |

***

## Trades (trades.md)

| Method | Path                        | Description                           | Auth |
| ------ | --------------------------- | ------------------------------------- | ---- |
| GET    | `/trades/{marketId}`        | Get recent trades for a market        | No   |
| GET    | `/users/{address}/activity` | Get user trade and settlement history | Yes  |

***

## Positions (positions.md)

| Method | Path                         | Description                         | Auth |
| ------ | ---------------------------- | ----------------------------------- | ---- |
| GET    | `/positions/{marketAddress}` | Get user position in a market       | Yes  |
| POST   | `/positions/{marketId}/sync` | Force-sync position from blockchain | Yes  |
| GET    | `/users/{address}/positions` | Get all positions across markets    | Yes  |

***

## Quick Markets (quick-markets.md)

| Method | Path                                   | Description                    | Auth |
| ------ | -------------------------------------- | ------------------------------ | ---- |
| GET    | `/quick-markets/{asset}`               | Get active quick market        | No   |
| GET    | `/quick-markets/{asset}/history`       | Get recent quick markets       | No   |
| GET    | `/quick-markets/{asset}/price`         | Get current asset price        | No   |
| GET    | `/quick-markets/{asset}/price-history` | Get 20-minute price history    | No   |
| GET    | `/quick-markets/{asset}/price-stream`  | SSE stream of real-time prices | No   |

***

## Resolution (resolution.md)

| Method | Path                     | Description                  | Auth |
| ------ | ------------------------ | ---------------------------- | ---- |
| GET    | `/resolution/{marketId}` | Get market resolution status | No   |

***

## Gasless Relayer (gasless-relayer.md)

| Method | Path                            | Description                          | Auth |
| ------ | ------------------------------- | ------------------------------------ | ---- |
| POST   | `/relayer/ctf-approval`         | Approve CTF transfers gaslessly      | Yes  |
| POST   | `/relayer/usdc-permit`          | Approve USDC spending gaslessly      | Yes  |
| POST   | `/relayer/ctf-redemption`       | Redeem outcome tokens for USDC       | Yes  |
| POST   | `/relayer/batch-ctf-redemption` | Batch redeem across multiple markets | Yes  |
| POST   | `/relayer/propose-resolution`   | Propose market resolution via UMA    | Yes  |
| POST   | `/relayer/settle-market`        | Settle market after dispute window   | Yes  |
| GET    | `/pending-claims`               | Get pending redemptions              | No   |
| GET    | `/failed-claims`                | Get failed redemptions               | No   |

***

## WebSocket (websocket.md)

| Protocol | Path      | Description                                    | Auth |
| -------- | --------- | ---------------------------------------------- | ---- |
| WS       | `/stream` | Real-time orderbook, trade, and market updates | No   |

### Event Types

| Event             | Description                      | Scope                   |
| ----------------- | -------------------------------- | ----------------------- |
| `orderbook`       | Full orderbook snapshot          | Per-market subscription |
| `trade`           | Trade executed                   | Per-market subscription |
| `trade_error`     | Settlement failed                | Per-market subscription |
| `order_cancelled` | Order cancelled                  | Per-market subscription |
| `quick_market`    | Quick market created or resolved | All clients             |