---
title: "Your plan, limits and usage"
method: GET
path: "/api/bot/v1/usage"
tags: ["Paper trading"]
---

# Your plan, limits and usage

`GET /api/bot/v1/usage`

## Request

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

Everything this key is allowed to do, read back from the server so a bot never has to hardcode a limit: the plan name and when it ends (plan_until), requests per minute and how many are left this window, keys, open positions, books, resting orders, webhooks, how many days of trade history this plan keeps (trade_history_days) and how far back the report may look (report_max_days), plus the catalogue of every plan and its price. If the account is inside a free month, free_month.days_left says so. Every keyed response also carries X-MP-Plan, and inside the last fourteen days X-MP-Plan-Expires and X-MP-Plan-Days-Left, so an unattended bot can warn its owner without calling this at all. Requires an API key.

## Response `200`

{ plan, plan_until, limits:{requests_per_minute, max_keys, max_open_positions, max_books, max_resting_orders, trade_history_days, report_max_days, websocket}, features, used, plans, free_month }

## Other responses

- `401`: missing_api_key / bad_api_key

---

[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)