# Fairground ## Docs - [Protocol Overview](https://docs.fairground.fi/index.md): Fairground perpetuals exchange with fixed fees, no funding rates, and one oracle price. - [Official Links](https://docs.fairground.fi/official-links.md): Trading app, socials, and other official resources. - [FAQs](https://docs.fairground.fi/faqs.md): Common questions about Fairground perpetual trading and Season 2 - [Trading Hours](https://docs.fairground.fi/trading-hours.md): Market hours for crypto, FX, stocks, and commodities - [Onboarding](https://docs.fairground.fi/trading/onboarding.md): Get set up to trade on Fairground - [Orders](https://docs.fairground.fi/trading/orders.md): How to place and modify positions - [Pricing](https://docs.fairground.fi/trading/pricing.md): The index price **_is_** the mark price - [Fees and Rebates](https://docs.fairground.fi/trading/fees-rebates.md): Fee mechanics and rebate allocations - [Miscellaneous UI](https://docs.fairground.fi/trading/miscellaneous-ui.md): UI-specific components and their descriptions - [Advanced Trading Overview](https://docs.fairground.fi/trading/advanced/overview.md): Deep dive into order matching, liquidations, the insurance fund, and ADL. - [Order Matching](https://docs.fairground.fi/trading/advanced/order-matching.md): How orders are matched and filled - [Liquidation](https://docs.fairground.fi/trading/advanced/liquidation.md): How liquidation works, when it triggers, and what happens to your margin - [Insurance Fund](https://docs.fairground.fi/trading/advanced/insurance-fund.md): When and how the insurance fund is used - [ADL (auto-deleveraging)](https://docs.fairground.fi/trading/advanced/adl.md): What ADL is, when it triggers, and what happens to positions - [Glossary](https://docs.fairground.fi/trading/advanced/glossary.md): Definition of terms used in the protocol - [XP Program](https://docs.fairground.fi/earn/xp-program.md) - [XP Program Terms](https://docs.fairground.fi/earn/xp-program-terms.md) - [Market Makers / LPs](https://docs.fairground.fi/earn/market-makers-lps.md): For liquidity providers and integrators - [API Reference](https://docs.fairground.fi/developers/api-overview.md): Integrate with Fairground via REST API - [Overview](https://docs.fairground.fi/developers/overview.md): Integrate with Fairground - [Error Selector Reference](https://docs.fairground.fi/developers/error-selector-reference.md): Decode on-chain revert reasons from their 4-byte hex. - [Introduction](https://docs.fairground.fi/developers/api-reference/introduction.md): Fairground API reference and integration guide - [GetUserFills](https://docs.fairground.fi/api-reference/trades/getuserfills.md): Returns individual trade-history records (fills) for one wallet, optionally scoped to a time range. Results are ordered oldest first (ascending by block time). - [GetMarketConfigs](https://docs.fairground.fi/api-reference/markets/getmarketconfigs.md): Returns the full configuration for one market, resolved by numeric `market_id` or by `market_symbol`. - [GetMarketSummary](https://docs.fairground.fi/api-reference/markets/getmarketsummary.md): Returns a live trading summary for one market: open interest, 24h price change and volume, executable order-book depth at the current price, rebate indicators, and whether the market is currently open for trading. If computing executable depth fails internally, the request still succeeds with… - [GetMarkets](https://docs.fairground.fi/api-reference/markets/getmarkets.md): Returns the full configuration for every active market, ordered by `market_id` ascending. - [GetOrderBook](https://docs.fairground.fi/api-reference/orderbook/getorderbook.md): Returns a simulated aggregated order-book depth for one market: bid and ask price levels, each bucketed by `tickSize` and sorted toward the best price. Resolved by `market_id` or `market_symbol`. - [GetOrder](https://docs.fairground.fi/api-reference/orders/getorder.md): Returns the current stored state of one order, identified by the composite key `order_id` + `market` + `reduce_only`. Order IDs are not globally unique: the same numeric ID can exist as both a position-opening order and a reduce-only order in the same market, so `reduce_only` must match the kind… - [GetOrders](https://docs.fairground.fi/api-reference/orders/getorders.md): Returns the latest stored state of each order associated with `address`, optionally filtered to one market. Results include position-opening and reduce-only orders across active and terminal statuses. This endpoint does not return order lifecycle events or individual fills. - [GetPortfolio](https://docs.fairground.fi/api-reference/portfolio/getportfolio.md): Returns an aggregated portfolio snapshot for one wallet: margin, PnL, volume, fee, and equity totals, plus the wallet's currently open positions and open orders. - [GetOpenPositions](https://docs.fairground.fi/api-reference/positions/getopenpositions.md): Returns all currently open positions for one wallet, across all markets. `address` is required (matched trimmed and case-insensitively). Results are ordered by timestamp descending, most recent first. - [GetHistoricalPrices](https://docs.fairground.fi/api-reference/prices/gethistoricalprices.md): Returns OHLC candlestick data for one market over a time range. - [GetPrice](https://docs.fairground.fi/api-reference/prices/getprice.md): Returns the current oracle price for one market, along with a signed price payload suitable for on-chain submission. ## OpenAPI Specs - [openapi](https://docs.fairground.fi/developers/api-reference/openapi.yaml) - [openapi-deferred](https://docs.fairground.fi/developers/api-reference/openapi-deferred.yaml)