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