---
title: "Tradable markets"
method: GET
path: "/api/bot/v1/markets"
tags: ["Paper trading"]
---

# Tradable markets

`GET /api/bot/v1/markets`

## Request

- Base URL: `https://marginpad.io`
- URL: `https://marginpad.io/api/bot/v1/markets`
- Auth: API key in header `X-API-Key`

Every tradable symbol with asset_class, max_leverage and taker_fee_pct (per side, charged as a round trip at close). Call once at startup instead of discovering limits by trial and error.

## Query parameters

- `class` string

## Response `200`

ok

- Markets
  - `markets` Market[]
    - `symbol` string
    - `asset_class` 'crypto' | 'stock' | 'forex' | 'metal' | 'index'
    - `max_leverage` number
    - `taker_fee_pct` number: Per side. Charged on notional, per side. position.margin is what you committed; position.feeOpen reports the entry leg for the cost breakdown only. BOTH legs settle in realized pnl at close; unrealized_pnl_usd excludes fees.
  - `count` integer
  - `note` string

---

[API](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api.md) · [All operations](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/revisions/27d21fcd0bf0?raw)