Bluesq
Developer reference

Documentation

Public market data can be read without an account. Trading, wallet and account operations require an authenticated session and a valid CSRF token.

Prediction API

Read-only endpoints used by the market interface.

  • GET /api/prediction/events - paginated events and filters
  • GET /api/prediction/events/{eventId} - event details
  • GET /api/prediction/events/{eventId}/snapshot - current market snapshot
  • GET /api/prediction/markets/{marketId}/price-history - historical prices
  • GET /api/prediction/search?q=... - market search

Authenticated API

These endpoints operate on the signed-in account and are not public integration keys.

  • GET /api/auth/session - current session
  • GET /api/betting/positions - account positions
  • GET /api/wallet/balance - available balances
  • GET /api/wallet/transactions - wallet ledger

Response and errors

JSON endpoints return standard HTTP status codes. A 401 response means the session is missing or expired; 403 means the account is not allowed to perform the operation.

  • Do not embed authenticated wallet endpoints in third-party pages.
  • Treat market prices as changing data and refresh snapshots before submitting an order.