Basics
https://falle.trade/api/v1- Every endpoint is a GET that returns JSON. CORS allows any origin, so a page can call it straight from the browser.
- Prices and amounts are US dollars as plain numbers, times are unix seconds, addresses are lowercase hex.
- A bad parameter answers 400 with
{ "error": "…" }. - Each network gets 240 requests a minute. The market board refreshes every 15 seconds, so polling faster gains nothing.
curl https://falle.trade/api/v1/prices
Markets & prices
Listed markets, their price inputs and pool candles.
/api/v1/marketsEvery listed market with its price inputs, leverage, maintenance, fee, tier, pool depth in both directions, session, whether it takes new positions and practice open interest. kind is major, stock or coin.
[{ "id": "ETH", "kind": "major", "price": 2557.05, "spot": 2559.26, "average": 2557.05, "chainlink": 2554.61,
"maxLeverage": 20, "maintenance": 0.02, "takerFee": 0.0006, "tier": null, "pumpDepthUsd": 4591447,
"session": "24/7", "open": true, "pause": null, "practice": { "longOiUsd": 0, "shortOiUsd": 0, "fundingPerDay": 0 } }, "…"]/api/v1/pricesMark and spot per market id, with the unix second the board was read.
{ "ETH": { "price": 2557.05, "spot": 2559.26, "ts": 1791398700 }, "…": "…" }/api/v1/candlesOHLC candles from the market's own pool, oldest first; t is the bucket start in unix seconds. source names where they came from.
| Parameter | Meaning |
|---|---|
| market | required, a market id such as ETH, NVDA or a coin id |
| tf | 1m, 5m, 15m, 1h (default), 4h or 1d |
{ "market": "ETH", "tf": "1h", "source": "Uniswap v3 pool history", "candles": [{ "t": 1791396000, "o": 2556.9, "h": 2559.4, "l": 2553.1, "c": 2558.3 }] }Activity & vault
Practice fills, the practice vault and the service health.
/api/v1/tradesRecent practice fills, newest first. Every row carries practice: true until the contracts are live.
| Parameter | Meaning |
|---|---|
| market | optional market id |
| limit | 1 to 200, default 50 |
[{ "t": 1791398712, "address": "0x…", "market": "ETH", "side": "long", "action": "open", "notional": 500, "pnl": null, "price": 2559.3, "practice": true }]/api/v1/vaultThe practice vault: NAV, share price, reserved profit, utilization and its running result.
{ "practice": true, "navUsd": 250000, "sharePrice": 1, "reservedUsd": 0, "utilization": 0, "resultUsd": 0 }/api/v1/healthChain id, latest block, when the market board was read, how many markets are listed, and whether trading is on chain or practice.
{ "ok": true, "chainId": 4663, "block": 82694223, "markets": 26, "mode": "practice", "practiceStorage": true }Trade button
Drop this link anywhere to send readers to a market with a side already picked. Change the market id and side in the URL; side is long or short.
Contracts
For anything that moves money, read the chain directly rather than this API.