> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lean.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Venues

> What the API supports on Kalshi, Polymarket, Polymarket US and Hyperliquid.

Lean trades on four venues: Kalshi, Polymarket, Polymarket US and Hyperliquid. One market can list
on several of them, and Lean reads every listing's book, prices the order across them and places it
where it fills best. This page shows what each venue supports, so you know where an order can go
before you send it.

Wherever a request or response names a venue, `venue` is one of `kalshi`, `polymarket`,
`polymarket_us` or `hyperliquid`.

## What each venue supports

| Feature | Kalshi | Polymarket | Polymarket US | Hyperliquid |
| - | - | - | - | - |
| [Markets](https://docs.lean.xyz/markets.md), quotes, books, trades, candles and prices | Yes | Yes | Yes | Yes |
| [Orders](https://docs.lean.xyz/orders.md), amends, cancels and fills | Yes | Yes | Yes | Yes |
| Balances, positions and PnL | Yes | Yes | Yes | Yes |
| [Stop losses](https://docs.lean.xyz/stop-losses.md) and take profits | Yes | Yes | Yes | Yes |
| [Limit chases](https://docs.lean.xyz/limit-chases.md) | Yes | Yes | Yes | Yes |
| `post_only` orders | Yes | No | Yes | Yes |
| `gtd` orders | Yes | Yes | Yes | No |
| `fok` orders | Yes | Yes | Yes | No |
| Paying for a buy with cash on another venue, and `best_price` | No | Yes | No | Yes |
| [Self signed routed orders](https://docs.lean.xyz/routed-orders.md) | No | Yes | No | Yes |
| [Deposits, withdrawals](https://docs.lean.xyz/funding.md) and [transfers](https://docs.lean.xyz/transfers.md) | No | Yes | No | Yes |
| [Test mode](https://docs.lean.xyz/test-mode.md) | Yes | Yes | Yes | Yes |

## Accounts and venue API keys

Polymarket and Hyperliquid balances belong to a trading account. Each trading account has its own
cash and shares there.

Kalshi and Polymarket US accounts belong to the user. Every trading account and API key of the user
shares the same Kalshi and Polymarket US cash and shares, so `GET /v1/balances` and
`GET /v1/positions` show the same figures for those venues under each of them.

A live order on Kalshi or Polymarket US goes out under the user's own API key for that venue. Connect
it once in the Lean app:

* Without it, a live order that needs that venue is refused with `403 FORBIDDEN`. Connect the key,
  or leave the venue out with `venues`.
* Test keys never reach a venue, so test orders on Kalshi and Polymarket US need no venue key.

## Naming markets

Each venue listing of a market is a leg with its own `ticker`:

| Venue | Leg `ticker` |
| - | - |
| Kalshi | The Kalshi market ticker, such as `KXNBAGAME-…` |
| Polymarket | Starts with `pm:`, such as `pm:0x…` |
| Polymarket US | Starts with `pmus:` |
| Hyperliquid | Starts with `hl:`, such as `hl:12` |

`GET /v1/markets?symbol=` takes any of these tickers and lists the markets that trade it, so you can
find the Lean market ID for a Kalshi or Polymarket US market. `GET /v1/markets?venue=` lists only
markets with a leg on that venue. Store the market ID and use it everywhere else. See
[Market IDs](https://docs.lean.xyz/markets.md#market-ids).

## Cash on each venue

| Venue | Cash | How to fund it |
| - | - | - |
| Kalshi | USD | On Kalshi directly |
| Polymarket | pUSD | Lean [deposits](https://docs.lean.xyz/funding.md) and [transfers](https://docs.lean.xyz/transfers.md) |
| Polymarket US | USD | On Polymarket US directly |
| Hyperliquid | USDC in spot | Lean [deposits](https://docs.lean.xyz/funding.md) and [transfers](https://docs.lean.xyz/transfers.md) |

Lean routes an order only to the venues that can pay for it. Between Polymarket and Hyperliquid, a
buy can pay with cash on the other venue: Lean moves the cash and buys on the venue with the book,
in the same call, and the order's `route` says so. A buy on Kalshi or Polymarket US pays with the
cash already on that venue. Shares never move between venues, so a sell or a stop loss sells on the
venue that holds the shares.

A test key starts with 10,000 simulated on each venue: USD on Kalshi and Polymarket US, pUSD on
Polymarket and USDC on Hyperliquid.

## Order terms on each venue

Each venue takes prices only on its own tick:

| Venue | Tick | Prices |
| - | - | - |
| Kalshi | Set by Kalshi for each market, such as `0.01`. | From one tick to 1 minus one tick. |
| Polymarket | Set by Polymarket for each market, such as `0.01` or `0.001`. | From one tick to 1 minus one tick. |
| Polymarket US | Set by Polymarket US for each market, such as `0.01`. | From one tick to 1 minus one tick. |
| Hyperliquid | `0.00001` | From `0.00001` to `0.99999`. |

`limit_price` must sit on the tick of every venue that could place the order. Lean never rounds it.

Some order terms narrow the venues an order can reach:

* A `post_only` order rests on Kalshi, Polymarket US or Hyperliquid. Polymarket can't rest a post
  only order.
* A `gtd` order goes to Kalshi, Polymarket or Polymarket US. Hyperliquid has no order expiry.
* A `fok` order goes whole to one venue: Polymarket, else Kalshi, else Polymarket US. Hyperliquid
  has no fill or kill. Polymarket takes a `fok` buy sized with `notional` only, so a `fok` buy sized
  with `quantity` goes to Kalshi or Polymarket US.

When no venue that lists the market can take the order, it is refused with
`400 VALIDATION_ERROR`. See [Orders](https://docs.lean.xyz/orders.md) for every term.

## Polymarket US books

Lean reads Polymarket US books from a live copy that starts on the first read of a market. Until
that copy is ready, a quote, preview or order that needs the book answers `503 UPSTREAM_ERROR`
with a `Retry-After` header, and nothing is placed. Send the same request again after that time.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.