Fortexa API

API состоит из двух частей. Котировки открыты без ключа: инструменты, текущие цены и свечи. Торговля требует API-ключ и подпись каждого запроса: баланс счёта, позиции, ордера и управление ими.

• Инструменты указываются в формате BASE/QUOTE: BTC/USDT, XAU/USD, EUR/USD. В адресе слэш кодируется как %2F.
• Время — миллисекунды Unix (UTC). Даты в позициях и ордерах — ISO 8601 в UTC.
• Суммы (маржа, баланс, PnL) — в долларах США. size — объём позиции в долларах: маржа × плечо. Тот же объём в лотах — lots.
• Объём ордера задаётся либо в лотах, либо суммой маржи. Размер лота зависит от инструмента и приходит в GET /v1/market/symbols (contractSize): золото — 100 унций, форекс — 100 000 единиц базовой валюты, нефть — 1000 баррелей, крипта — 1 монета. Маржу под заданный объём считает сервер по цене исполнения — пересчитывать на своей стороне ничего не нужно.
• Цены в API — это цены, по которым исполняет платформа. Рыночный ордер исполняется по цене сервера, а не по цене, присланной клиентом.
• Котировки можно запрашивать из браузера (CORS открыт). Торговые эндпоинты предназначены для серверов: никогда не размещайте секрет на веб-странице.
• Потоки WebSocket в API v1 пока не входят — опрашивайте тикер в пределах лимитов.

Ключи создаются в личном кабинете: Dashboard → API Keys.

Каждый торговый запрос передаёт четыре заголовка:

X-FX-SIGN = HEX( HMAC_SHA256( secret, timestamp + apiKey + recvWindow + payload ) )

• payload для GET — строка запроса ровно в том виде, как отправлена, без ? (пустая, если параметров нет).
• payload для POST — тело JSON ровно в том виде, как отправлено. Подписывайте и отправляйте одну и ту же строку, не сериализуйте объект повторно.
• recvWindow в подписываемой строке должен совпадать с заголовком X-FX-RECV-WINDOW; если заголовок не передаёте, подписывайте с 5000.
• Запрос старше recvWindow отклоняется, метка времени более чем на 1 секунду в будущем — тоже. Синхронизируйте часы по GET /v1/time.
• Каждый подписанный POST выполняется только один раз: повторная отправка того же запроса вернёт 409 duplicate_request. Для повтора подпишите запрос заново с новой меткой времени и используйте clientOrderId, чтобы ордер не создался дважды.

Эталонные значения для проверки своей реализации:

secret      your-api-secret
apiKey      fx0123456789abcdef0123456789abcd
timestamp   1700000000000
recvWindow  5000

GET /v1/positions?symbol=XAU%2FUSD
payload     symbol=XAU%2FUSD
string      1700000000000fx0123456789abcdef0123456789abcd5000symbol=XAU%2FUSD
X-FX-SIGN   dc2ab26e240569c88af6ed4d68f790ef44f91a27af07893f362927d9cae8280e

POST /v1/orders
payload     {"symbol":"XAU/USD","side":"buy","type":"market","margin":50,"leverage":20}
string      1700000000000fx0123456789abcdef0123456789abcd5000{"symbol":"XAU/USD","side":"buy","type":"market","margin":50,"leverage":20}
X-FX-SIGN   4f274b3465a3019f3342e0998ffaed46ac687549819ec058cfaedc986d7e10fb

При превышении лимита API отвечает 429 rate_limited с заголовком Retry-After: 1.

Ошибки приходят с HTTP-статусом и телом JSON. Логику бота стройте на code — он стабилен; message — для человека и может меняться.

{
  "code": "invalid_signature",
  "message": "Signature mismatch"
}

Все эндпоинты ниже требуют подписи и работают только со счётом, к которому привязан ключ. Лишние поля в теле запроса отклоняются с bad_request.

{
  "accountType": "demo",
  "canTrade": true,
  "currency": "USD",
  "balance": {
    "available": 9850.5,
    "locked": 149.5,
    "total": 10000.0
  }
}

{
  "positions": [ /* объект позиции */ ]
}

{
  "positionId": 1542,
  "symbol": "XAU/USD",
  "side": "buy",
  "status": "open",
  "entryPrice": 4268.4,
  "markPrice": 4273.97,
  "size": 1000.0,
  "lots": 0.0023,
  "margin": 50.0,
  "leverage": 20,
  "liquidationPrice": 4054.98,
  "takeProfit": 4300.0,
  "stopLoss": 4220.0,
  "pnl": 1.3,
  "pnlPercent": 2.61,
  "fee": 0.7,
  "swap": 0.6,
  "openedAt": "2026-09-14T13:41:07.512",
  "closedAt": null,
  "closeReason": null
}

{
  "orderId": 1543,
  "symbol": "EUR/USD",
  "side": "sell",
  "type": "limit",
  "status": "new",
  "price": 1.162,
  "lots": 0.0427,
  "margin": 100.0,
  "leverage": 50,
  "fee": 1.2,
  "takeProfit": 1.155,
  "stopLoss": null,
  "createdAt": "2026-09-14T13:45:00.118"
}

{
  "symbol": "XAU/USD",
  "side": "buy",
  "type": "market",
  "lots": 0.01,
  "leverage": 100,
  "clientOrderId": "bot-gold-001"
}

{
  "symbol": "EUR/USD",
  "side": "sell",
  "type": "limit",
  "price": 1.162,
  "margin": 100,
  "leverage": 50,
  "takeProfit": 1.155,
  "clientOrderId": "grid-eu-017"
}

{
  "orderId": 1543,
  "status": "new",
  "clientOrderId": "grid-eu-017",
  "order": { /* объект ордера */ }
}

{
  "orderId": 1542,
  "positionId": 1542,
  "status": "filled",
  "clientOrderId": null,
  "position": { /* объект позиции */ }
}

// запрос
{ "orderId": 1543 }

// ответ
{ "orderId": 1543, "status": "cancelled" }

// запрос
{ "orderId": 1543, "price": 1.165 }

// ответ
{ "order": { /* объект ордера */ } }

// запрос
{ "positionId": 1542 }

// ответ
{ "position": { /* объект позиции, status: closed */ } }

// сдвинуть стоп, тейк-профит оставить
{ "positionId": 1542, "stopLoss": 4235 }

// снять тейк-профит
{ "positionId": 1542, "takeProfit": null }

Сделка стоит двух вещей: комиссии за круг и платы за перенос через ночь. Обе удерживаются один раз, при закрытии позиции: на счёт возвращается margin + pnl − fee − swap.

Комиссия за круг

Считается при открытии позиции и хранится в её поле fee. Она покрывает и открытие, и закрытие — дважды не берётся. Ставка за лот по каждому инструменту — feePerLotUsd в GET /v1/market/symbols. У отложенного ордера комиссия посчитана сразу, её видно ещё до исполнения.

Плата за перенос через ночь (своп)

Позиция, оставшаяся открытой в момент пересчёта суток, платит за перенос. Ставка — процент от объёма позиции за ночь, отдельно для лонга и шорта: swapLongPctPerDay и swapShortPctPerDay в GET /v1/market/symbols.

• Пересчёт суток происходит в swapChargeHourUtc (00:00 UTC). Позиция, открытая после него, первый раз платит на следующую ночь.
• Крипта платит каждую ночь, включая выходные. Форекс, металлы и нефть в субботу и воскресенье не платят, зато тройную ставку берут в swapTripleWeekday (0 = понедельник) — так оплачивается перенос через выходные.
• Накопленная сумма лежит в поле swap позиции и растёт каждую ночь.
• Накопленный своп съедает маржу, поэтому liquidationPrice у долгой позиции смещается. Читайте его из ответа, а не считайте по плечу.

Текущие ставки за ночь, в процентах от объёма (эталонные значения всегда берите из /v1/market/symbols):

Котировки без ключа (cURL):

curl "https://api.fortexatrade.com/v1/market/ticker?symbol=XAU%2FUSD"

curl "https://api.fortexatrade.com/v1/market/klines?symbol=BTC%2FUSDT&interval=1h&limit=100"

Клиент на Python с подписью (нужен пакет requests):

import hashlib
import hmac
import json
import time
from urllib.parse import urlencode

import requests

BASE_URL = "https://api.fortexatrade.com"
API_KEY = "fx..."          # из кабинета: Dashboard -> API Keys
API_SECRET = "..."         # показывается один раз при создании ключа
RECV_WINDOW = "5000"


def _headers(payload: str) -> dict:
    timestamp = str(int(time.time() * 1000))
    message = timestamp + API_KEY + RECV_WINDOW + payload
    signature = hmac.new(API_SECRET.encode(), message.encode(), hashlib.sha256).hexdigest()
    return {
        "X-FX-API-KEY": API_KEY,
        "X-FX-TIMESTAMP": timestamp,
        "X-FX-RECV-WINDOW": RECV_WINDOW,
        "X-FX-SIGN": signature,
        "Content-Type": "application/json",
    }


def get(path: str, params: dict | None = None) -> dict:
    query = urlencode(params or {})
    url = BASE_URL + path + ("?" + query if query else "")
    return requests.get(url, headers=_headers(query), timeout=10).json()


def post(path: str, body: dict) -> dict:
    # Подписываем и отправляем ОДНУ и ту же строку — без повторной сериализации.
    payload = json.dumps(body, separators=(",", ":"))
    return requests.post(BASE_URL + path, data=payload, headers=_headers(payload), timeout=10).json()


print(get("/v1/account"))
print(get("/v1/positions", {"symbol": "XAU/USD"}))

# Сначала на демо-ключе!
order = post("/v1/orders", {
    "symbol": "XAU/USD",
    "side": "buy",
    "type": "limit",
    "price": 4250,
    "margin": 50,
    "leverage": 20,
    "takeProfit": 4300,
    "stopLoss": 4220,
    "clientOrderId": "grid-001",
})
print(order)

Клиент на Node.js с подписью:

// Node.js 18+ (встроенные fetch и crypto)
import crypto from "node:crypto";

const BASE_URL = "https://api.fortexatrade.com";
const API_KEY = process.env.FX_API_KEY;
const API_SECRET = process.env.FX_API_SECRET;
const RECV_WINDOW = "5000";

function headers(payload) {
  const timestamp = Date.now().toString();
  const signature = crypto
    .createHmac("sha256", API_SECRET)
    .update(timestamp + API_KEY + RECV_WINDOW + payload)
    .digest("hex");
  return {
    "X-FX-API-KEY": API_KEY,
    "X-FX-TIMESTAMP": timestamp,
    "X-FX-RECV-WINDOW": RECV_WINDOW,
    "X-FX-SIGN": signature,
    "Content-Type": "application/json",
  };
}

export async function get(path, params = {}) {
  const query = new URLSearchParams(params).toString();
  const url = BASE_URL + path + (query ? `?${query}` : "");
  const res = await fetch(url, { headers: headers(query) });
  return res.json();
}

export async function post(path, body) {
  // Подписываем и отправляем одну и ту же строку.
  const payload = JSON.stringify(body);
  const res = await fetch(BASE_URL + path, { method: "POST", body: payload, headers: headers(payload) });
  return res.json();
}

console.log(await get("/v1/account"));
console.log(await post("/v1/orders/cancel", { orderId: 1543 }));

• Храните секрет только на сервере — в переменных окружения или хранилище секретов, а не в репозитории кода.
• Всегда задавайте белый список IP для торговых ключей.
• Для мониторинга и аналитики используйте ключи только для чтения.
• Для каждого бота создавайте отдельный ключ — так один можно отозвать, не останавливая остальные.
• Сначала проверьте стратегию на демо-ключе, затем создайте ключ реального счёта.
• Если секрет утёк, сразу удалите ключ в кабинете — он перестанет работать мгновенно.