Fortuna API Documentation

Build on top of Fortuna Protocol. Access markets, trades, users, and statistics through our REST API.

Base URL:https://fortuna.fyi/api/v1

Quick Start

All endpoints return JSON. No authentication required for read operations.

// Fetch all active markets
fetch('https://fortuna.fyi/api/v1/markets?status=active')
  .then(res => res.json())
  .then(data => console.log(data.data.markets));

// Get market details
fetch('https://fortuna.fyi/api/v1/markets/YOUR_MARKET_ID')
  .then(res => res.json())
  .then(data => console.log(data.data.market));

Markets

Users

Statistics

WebSocket (Real-time)

Subscribe to real-time trade updates via WebSocket.

import { io } from 'socket.io-client';

const socket = io('wss://fortuna.fyi');

// Subscribe to a market
socket.emit('subscribe-market', 'YOUR_MARKET_ID');

// Listen for new trades
socket.on('new-trade', (trade) => {
  console.log('New trade:', trade);
});

// Listen for price updates
socket.on('price-update', (data) => {
  console.log('Price update:', data);
});

Rate Limits

Currently no rate limits enforced. Please be respectful with your requests. We reserve the right to implement rate limiting if needed.