Exchange

Appearance

🌐Network: Mainnet▼

Aggregator Endpoints ​

The Aggregator API provides an alternative interface for accessing o2 Exchange data using market pair notation (e.g., FUEL_USDC) instead of market IDs. These endpoints are designed for integration with cryptocurrency data aggregators and third-party platforms.

Key Difference: Aggregator endpoints use market_pair format (e.g., "FUEL_USDC") instead of numeric market_id values used in standard endpoints.

Rate Limit: All aggregator endpoints are rate limited to 5 requests/second (IP-based).

Get Assets ​

Retrieve a list of all available trading assets with their metadata, fees, and deposit/withdrawal capabilities.

GET /v1/aggregated/assets

curl -X GET \
  "https://api.o2.app/v1/aggregated/assets" \
  -H "Accept: application/json"

Response Structure: Returns a map of asset symbols to asset information.

Source: packages/api/src/app/routes/v1/aggregated/assets.rs:28

Get Order Book Depth ​

Retrieve order book depth (bids and asks) for a specific market pair.

GET /v1/aggregated/orderbook

Query Parameters

curl -X GET \
  "https://api.o2.app/v1/aggregated/orderbook" \
  -H "Accept: application/json"

Query Parameters:

  • market_pair (required): Market pair in format BASE_QUOTE (e.g., "FUEL_USDC")
  • depth (optional): Number of price levels to return. Default: 500, Max: 500. Use 0 for full depth.
  • level (optional): Order book level (2 or 3). Currently both return the same aggregated data. Default: 2.

Source: packages/api/src/app/routes/v1/aggregated/orderbook.rs:41

Get Market Summary ​

Get 24-hour market statistics and summary data for all trading pairs.

GET /v1/aggregated/summary

curl -X GET \
  "https://api.o2.app/v1/aggregated/summary" \
  -H "Accept: application/json"

Response Structure: Returns an array of market summaries for all available pairs.

Source: packages/api/src/app/routes/v1/aggregated/summary.rs:65

Get Market Ticker ​

Get real-time ticker data for all trading pairs, including last price and volume.

GET /v1/aggregated/ticker

curl -X GET \
  "https://api.o2.app/v1/aggregated/ticker" \
  -H "Accept: application/json"

Response Structure: Returns a map of market pairs to ticker data.

Source: packages/api/src/app/routes/v1/aggregated/ticker.rs:21

Get Recent Trades ​

Retrieve recent trades for a specific market pair.

GET /v1/aggregated/trades

Query Parameters

curl -X GET \
  "https://api.o2.app/v1/aggregated/trades" \
  -H "Accept: application/json"

Query Parameters:

  • market_pair (required): Market pair in format BASE_QUOTE (e.g., "FUEL_USDC")

Response Structure: Returns an array of recent trades (most recent first).

Source: packages/api/src/app/routes/v1/aggregated/trades.rs:48