Endpoints

Quick reference for all Turbine API endpoints.

Base URL: https://api.turbinefi.com/api/v1

Authentication

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

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	/platform/stats/history	Get daily volume/trade time-series	No
GET	/comments/{marketId}	Get market comments	No
POST	/comments/{marketId}	Post a comment	Yes

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

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

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

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

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

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

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

Method	Path	Description	Auth
GET	/rewards/markets	List markets with reward pools	No
GET	/rewards/market/{marketId}	Get reward leaderboard for a market	No
GET	/rewards/user/{address}	Get reward payout history	No
GET	/rewards/user/{address}/total	Get lifetime reward total	No
GET	/rewards/user/{address}/today	Get current period accrued scores	No

Method	Path	Description	Auth
GET	/rebates/user/{address}	Get rebate payout history	No
GET	/rebates/user/{address}/total	Get lifetime rebate total	No
GET	/rebates/user/{address}/today	Get current period maker fee accruals	No

Method	Path	Description	Auth
GET	/user-stats	Get all users' trading P&L statistics	No

Method	Path	Description	Auth
GET	/bot-battle/leaderboard	Get market maker bot battle leaderboard	No

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

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