Market data

Nothing on this page needs a key. Every route here is cached server-side and shared across callers, so the answer you get is the answer the app's own screens are rendering.

GET/api/prep/markets

The moving half of the market data: prices, 24h statistics, funding and open interest. Active markets only, sorted by 24h quote volume, descending. Cached for five seconds.

{
  "markets": [
    {
      "symbol": "PERP_ETH_USDC",
      "display_symbol_name": "ETH",
      "status": "ACTIVE",
      "index_price": 2412.55,
      "mark_price": 2412.61,
      "sum_unitary_funding": 12.4471,
      "est_funding_rate": 0.0000125,
      "last_funding_rate": 0.0000098,
      "next_funding_time": 1717174800000,
      "open_interest": 18422.4,
      "24h_open": 2380.1,
      "24h_close": 2412.61,
      "24h_high": 2440.0,
      "24h_low": 2361.2,
      "24h_volume": 91422.5,
      "24h_amount": 220144821.3,
      "base": "ETH",
      "change24hPct": 1.3659
    }
  ]
}

base and change24hPct are computed here; everything else is the upstream row. change24hPct is a percentage, not a fraction, and is zero when the open was zero.

GET/api/prep/market-rules

The static half: tick sizes, notional limits, precision and maximum leverage. Cached for an hour, because these change when a market is relisted and almost never otherwise. Join it to the prices on your side rather than re-downloading it on a poll.

{
  "rules": [
    {
      "symbol": "PERP_ETH_USDC",
      "maxLeverage": 50,
      "info": {
        "symbol": "PERP_ETH_USDC",
        "display_symbol_name": "ETH",
        "quote_min": 0,
        "quote_max": 100000,
        "quote_tick": 0.01,
        "base_min": 0.001,
        "base_max": 1000,
        "base_tick": 0.0001,
        "min_notional": 10,
        "price_range": 0.03,
        "price_scope": 0.4,
        "funding_period": 8,
        "cap_funding": 0.0075,
        "floor_funding": -0.0075,
        "base_imr": 0.02,
        "base_mmr": 0.01
      }
    }
  ]
}

• base_tick is the quantity step. An order size that is not a multiple of it is rejected.
• quote_tick is the price step for a limit order.
• min_notional is the smallest order value. Size times price must clear it.
• maxLeverage is derived here as the reciprocal of base_imr, rounded, because the leverage is not published directly.

GET/api/prep/orderbook

Never cached: a stale book is worse than no book. Prices and quantities are strings, not numbers.

{
  "symbol": "PERP_ETH_USDC",
  "mid_price": "2412.58",
  "spread": "0.06",
  "asks": [{ "price": "2412.61", "quantity": "4.2" }],
  "bids": [{ "price": "2412.55", "quantity": "6.8" }],
  "ts": 1717171717171
}

GET/api/prep/candles

{
  "rows": [
    {
      "open": "2380.10",
      "high": "2440.00",
      "low": "2361.20",
      "close": "2412.61",
      "volume": "91422.5",
      "timestamp": 1717171200000
    }
  ]
}

GET/api/prep/trades

{
  "trades": [
    {
      "symbol": "PERP_ETH_USDC",
      "side": "BUY",
      "executed_price": 2412.61,
      "executed_quantity": 0.4,
      "executed_timestamp": 1717171717171
    }
  ]
}

The public tape. It carries no identity: there is no address on a fill and no way to attribute one.

GET/api/prep/funding

{
  "symbol": "PERP_ETH_USDC",
  "est_funding_rate": 0.0000125,
  "last_funding_rate": 0.0000098,
  "next_funding_time": 1717174800000,
  "sum_unitary_funding": 12.4471
}

A positive rate means longs pay shorts. Every market carries est_funding_rate on /api/prep/markets too, so ranking the whole board takes one call rather than one per symbol.

GET/api/prep/config

No parameters. The account-level leverage ladder, parsed into numbers and cached for an hour.

{ "leverageSteps": [1, 2, 3, 4, 5, 10, 20, 50] }

GET/api/prep/tokens

No parameters. Collateral assets and their per-chain details, cached for an hour.

{
  "rows": [
    {
      "token": "USDC",
      "decimals": 6,
      "chain_details": [
        { "chain_id": "42161", "withdraw_fee": 1.0, "decimals": 6 }
      ]
    }
  ]
}

GET/api/prep/deposit-chains

No parameters. Chains this venue accepts settlement-asset deposits on, joined with the USDC address on each. A chain with no USDC address is dropped, because it cannot be deposited from whatever the vault list says.

{
  "rows": [
    {
      "chainId": 42161,
      "name": "Arbitrum",
      "vault": "0x<20 byte address>",
      "usdc": "0x<20 byte address>",
      "explorer": "https://arbiscan.io",
      "nativeSymbol": "ETH",
      "withdrawalFee": 1.0,
      "decimals": 6
    }
  ]
}

GET/api/prep/insurance-fund

No parameters. The balance of the fund that backstops liquidations. The handler forwards the upstream object without reshaping it and the code declares it only as an object, so the field names are not documented here rather than guessed at. Call it once and read what comes back.

GET/api/prep/liquidations

The exchange-wide liquidation feed, as { "rows": [...] }. The row shape is the upstream's and the code declares it only as an object, so it is not written out here.

GET/api/prep/leaderboard

An invalid parameter falls back rather than failing: a leaderboard is a browsing surface, and refusing to render one because a query string was mistyped serves nobody. window applies to volume and pnl only — open notional is the book as it stands now, so sorting by notional ignores the window rather than quietly meaning something by it.

{
  "rows": [
    {
      "address": "0x1234…abcd",
      "rank": 1,
      "volume": 91422533.1,
      "pnl": 184221.7,
      "notional": 4210044.9
    }
  ],
  "total": 50,
  "updatedAt": 1717171717171
}

total is how many ranked rows this response carries, not how many traders the platform has. There is no grand total to report, so none is invented.

GET/api/prep/whales

The same rows and the same shape as the leaderboard, fixed to a 24h window and sorted by open notional. Size is what moves a market, and it is the one of the two that a lucky week cannot fake.

GET/api/prep/points

Merits earned by one address, plus the epoch dates. The rewards module is enabled per operator and is not switched on for this one, so this answers 200 with enabled false rather than an error: a feature that is off is a configuration state, not a fault.

{ "enabled": false, "merits": null, "epochs": null }

When it is switched on, merits and epochs carry the upstream payloads and enabled becomes true. A timeout or a rate limit still surfaces as an error, because reporting an outage as a feature flag would hide it.

GET/api/prep/op/{id}

One dispatcher for every catalogued read. Path parameters are supplied in the query string, substituted into the upstream path and encoded, so a value cannot escape its segment. Only the parameters listed for an operation are forwarded; anything else is dropped rather than passed along.

• An unknown id is not_found, because the catalogue is published and asking for something absent from it is a stale client.
• A missing required parameter is invalid_request naming the parameter.
• broker_id, where an operation takes one, is always set to this operator's. A caller cannot ask about another.
• Named routes win over this one. /api/prep/markets keeps its own shaped response; everything else falls through to here.

curl 'https://swapmos.com/api/prep/op/funding.history?symbol=PERP_ETH_USDC&size=50'

The response is the upstream payload for that operation, scrubbed, at the top level. These are pass-throughs, so their field names are the upstream's and are not restated here. Cache-control is set from the operation's own cache lifetime, or no-store when it is zero.