Upscale
Menu
On this page

API Trading

API Trading is an additional option that opens up programmatic trading on a specific challenge: connecting a trading bot, your own scripts, analytics tooling or an AI agent.

Eligibility

ParameterValue
Minimum account notional$10,000 — the option is unavailable on $1,000 and $5,000 accounts
Costthe option is currently free
Challenge phasecan be enabled until the account moves to the funded stage
Demo accountthe option is activated when the challenge is created

A discount on the challenge does not apply to the cost of options: paid options are always charged in full.

When it can be enabled

The option is selected at checkout. After payment the challenge is immediately marked API-enabled and the additional rules start applying to it.

What comes with the option

RuleWhat it means
Request rate limitexceeding it returns an error and the request is not executed
60-second profit adjustmentA profitable close made less than 60 seconds after the position was opened or increased is not counted
30% ruleThe single most profitable day must not account for 30% or more of total profit — a condition for passing each stage and for payout eligibility

The mechanics of both rules are described on the Challenge & Trading Rules page.

How it appears in the interface

The account card shows an API icon among the connected options, along with a "Max profit day" block displaying the current figure for the 30% rule — exactly as on Turbo accounts.

If the 60-second adjustment was applied to a close or a partial close, the position history shows the counted result as 0 USD. Hovering on desktop or tapping on mobile brings up an explanation with the reason and the original profit figure. Position and account totals use the adjusted value only.

Who it suits

The option is for traders working algorithmically: connecting a bot or an AI agent, automating entries and exits, or collecting trading telemetry with their own tools.

If you trade manually and have no plans to connect programmatic tools, there is no reason to enable it: you will not use the API access, but the restrictions on the account will still be there.


Quick start

An API key is created in the terminal, in the API and MCP section of your account settings, on the API keys tab. Only accounts with the API Trading option enabled are available through the API. The option can be enabled on the same page, using the button to set up accounts.

The key is meant for the account owner only: do not publish it and do not pass it to other traders. Sharing a key is a breach of the rules.

Everything you need for API trading is collected in the Developers section — a separate part of the documentation for developers.

What you will find thereWhat it is for
Quick startopening and closing a position in five calls, with ready-to-run JavaScript and Python scripts
Authenticationhow to get an API key and send it with your requests
Conventionsnumber format, the units used by the fields, and how repeated requests are handled
Rate limitsthe cap on how often you can call the API
Errorsresponse codes and what they mean
Operationsa reference of the calls, grouped into Accounts, Configuration and Trading

Every call in the reference can be run straight from its page: the API Playground takes your key and parameters, and the send button returns a real response from the platform. The same block holds ready-made request code for cURL, JavaScript and Python.


Connecting an AI agent via MCP

You can connect an AI agent — ChatGPT, Claude, Claude Code or Cursor — to your accounts. The agent works over MCP: it shows account data and open positions and can place orders at your request.

The agent can access only accounts with the API Trading option enabled, and all the option's rules described above apply to them. If you have no such accounts, the platform suggests enabling the option or trying the agent on a demo account.

Server address: https://mcp.upscale.trade

  1. Open the API and MCP settings, go to the MCP tab, click "Connect" and choose your agent: each one has step-by-step instructions.
  2. Add the server address in the agent's settings.
  3. The agent opens a confirmation page in your browser. Click "Allow access" and return to the agent.

Example for Claude Code:

claude mcp add --transport http upscale https://mcp.upscale.trade

Connections made by server address appear on the MCP tab with the connection date and the time of last use. The "Disconnect" button immediately revokes the agent's access to your accounts. Connections made by API key are not shown in this list: to disconnect such an agent, delete the key.

You can create up to 10 API keys per account. Every agent connected by server address also counts towards this limit.

Last updated