Быстрый старт с API

Цена кредита: $0.001 (1000 бесплатных кредитов при регистрации). Базовый URL https://api.marketapi.app/v1. Передавайте ключ в заголовке Authorization. Ключи в URL отклоняются.

curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/bars?symbol=EURUSD&timeframe=M1&from=2026-09-01T00:00:00Z&to=2026-09-02T00:00:00Z"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/symbols/EURUSD"

EURUSD и XAUUSD — лишь примеры: подставьте вместо них нужный тикер, написанный точно как в списке цен (по рынкам: форекс, металлы, индексы, акции, энергоносители, криптовалюты, с поиском) или в списке тикеров (CSV). Несколько тикеров разделяются запятыми.

Два продукта — один ключ API. API рыночных цен ниже отдаёт цены приложениям, ботам и дашбордам. Ончейн-оракул цен отдаёт те же цены в виде подписанных отчётов, которые смарт-контракты проверяют ончейн.

Эндпоинты

Насколько далеко уходят свечи: M1 7 days · M2–M6 30 days · M10–M30 3 months · H1 12 months · H2–H12 3 years · D1–MN1 5 years (насколько хватает собственной истории рынка).

Ончейн-оракул цен (для смарт-контрактов)

Используйте те же цены форекса, золота, индексов и акций внутри смарт-контрактов — для DeFi-кредитования, токенизированных активов (RWA), ончейн-FX, платежей в стейблкоинах и синтетических активов. Ваше приложение получает подписанный ценовой отчёт; ваш контракт передаёт его нашему контракту-верификатору, который проверяет подпись ончейн. Цену нельзя подделать при передаче, и никому не нужно доверять посреднику.

1. Получите отчёт с помощью ключа API:

   curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/oracle/report?symbols=XAUUSD&chain_id=10"

2. Передайте его report и signature в submit() верификатора в своей транзакции.
3. Прочитайте проверенную цену через getPriceNoOlderThan(feedId, maxAge). Функция возвращает только живую цену (рынок OPEN) не старше maxAge.

Каждый отчёт указывает статус рынка (OPEN, CLOSED, HALTED) и спред bid-ask и истекает примерно через минуту после подписи. У фидов фиксированные ID (keccak256("XAUUSD")), защитные механизмы останавливают аномальные скачки, доступен адаптер, совместимый с Chainlink (latestRoundData). Цены, уже записанные в блокчейн нашим релейером, можно читать бесплатно.

Документация оракула Фиды, сети и контракты

Бесплатный тариф (без ключа)

Попробуйте API без аккаунта: 10 запросов в минуту и 1000 в день на IP-адрес, до 5 символов за запрос.

curl "https://api.marketapi.app/v1/free/prices/latest?symbols=EURUSD"
curl "https://api.marketapi.app/v1/free/symbols"
curl "https://api.marketapi.app/v1/free/market-status?symbols=EURUSD"

Нужно больше? Создайте аккаунт для полного доступа со своим ключом API.

Статус цены

У каждой цены есть status, который говорит только одно: насколько цена актуальна.

Добавьте require_live=true, чтобы получать только цены LIVE; исключённые символы не оплачиваются. Каждый запрошенный тикер попадает ровно в один список: data (есть цена), no_data (известный тикер, цены пока нет) или unknown (не предлагается).

Часы торгов. Форекс, металлы и большинство индексов торгуются с вечера воскресенья до вечера пятницы (UTC). CFD на акции и ETF следуют основной сессии своей биржи по местному времени, с переходом на летнее время: Нью-Йорк 09:30–16:00, Лондон 08:00–16:30, Франкфурт и Париж 09:00–17:30. Биржевые праздники (NYSE, LSE, Xetra, Euronext) считаются закрытыми днями. Вне этих часов цена имеет статус MARKET_CLOSED, а не STALE; если источник всё же котирует (например, до открытия), цена имеет статус LIVE.

Спецификации инструментов

GET /v1/symbols/{symbol} возвращает полную спецификацию инструмента в том виде, в каком её сообщает источник, включая валюты, размер контракта, размер тика и лимиты объёма, вместе с торговыми сессиями. GET /v1/symbols/{symbol}/properties/history перечисляет все её изменения. Список тикеров (CSV) содержит основные поля спецификации.

Безопасные повторы

Отправляйте заголовок Idempotency-Key, чтобы повторы были безопасными: повтор запроса с тем же ключом в течение 24 часов возвращает ровно первый ответ, без списания (ответы до 2 МБ). Для свежих данных отправьте новый ключ; ключ, ответ на который уже не хранится, получает 409 idempotency_key_used.

Цены в реальном времени (торговые боты, дашборды)

Два способа получить самую свежую цену. Оба дают одинаковые котировки; выбирайте по тому, как работает ваша программа.

Насколько свежа цена?

Символы, которые вы получаете стримингом или запрашивали через /prices/latest за последние 5 минут, обновляются из источника примерно каждую секунду (одновременно до таких символов на всех клиентов). Все остальные символы обновляются непрерывно в фоне, но реже. Поэтому запрашивайте символы, которыми торгуете, или подписывайтесь на них — и они станут быстрыми.

Каждая котировка содержит time — момент, когда её выдал источник (UTC), и status. Торговая программа всегда должна проверять оба:

• Используйте require_live=true в REST-вызовах: возвращаются только цены LIVE (остальные перечисляются отдельно и не оплачиваются).
• Сравнивайте time со своими часами и игнорируйте котировки старше, чем допускает ваша стратегия. Рынки бывают тихими: цена вполне может некоторое время не меняться.

Пример REST

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"

{"data": [{"symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
           "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}],
 "not_live": [], "unknown": [], "no_data": []}

Опрашивать чаще раза в секунду бессмысленно: именно так часто источник читается для активных символов.

Протокол WebSocket

Подключитесь к /stream с заголовком Authorization: Bearer <your key> (право read:latest). Затем отправляйте JSON-сообщения:

> {"action": "subscribe",   "symbols": ["EURUSD", "XAUUSD"]}
< {"type": "subscribed", "symbols": ["EURUSD", "XAUUSD"], "rejected": []}
< {"type": "quote", "symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
   "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}
> {"action": "unsubscribe", "symbols": ["XAUUSD"]}
< {"type": "error", "code": "...", "detail": "..."}

Лимиты: до 50 символов на соединение. Коды закрытия: 4401 — недействительный ключ, 4402 — баланс исчерпан (пополните и переподключитесь), 4429 — слишком много открытых соединений. Сервер отправляет пинги каждые 20 секунд; большинство библиотек WebSocket отвечают на них автоматически.

Пример на Python (pip install "websockets>=14")

import asyncio, json, os, websockets

async def main():
    url = "/stream"
    headers = {"Authorization": "Bearer " + os.environ["API_KEY"]}
    while True:                                   # reconnect with backoff
        try:
            async with websockets.connect(url, additional_headers=headers) as ws:
                await ws.send(json.dumps({"action": "subscribe", "symbols": ["EURUSD"]}))
                async for raw in ws:
                    msg = json.loads(raw)
                    if msg["type"] == "quote" and msg["status"] == "LIVE":
                        print(msg["symbol"], msg["bid"], msg["ask"], msg["time"])
        except websockets.ConnectionClosed as e:
            if e.code in (4401, 4402):            # wrong key / no balance: retrying will not help
                raise
        await asyncio.sleep(5)

asyncio.run(main())

Пример на Node.js (npm install ws)

const WebSocket = require("ws");
const ws = new WebSocket("/stream", { headers: { Authorization: "Bearer " + process.env.API_KEY } });
ws.on("open", () => ws.send(JSON.stringify({ action: "subscribe", symbols: ["EURUSD"] })));
ws.on("message", (raw) => {
  const m = JSON.parse(raw);
  if (m.type === "quote" && m.status === "LIVE") console.log(m.symbol, m.bid, m.ask, m.time);
});
ws.on("close", (code) => console.log("closed", code));   // reconnect after a few seconds unless 4401/4402

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

Полезно знать

• Цены — это собственные bid и ask источника; price_basis в /symbols указывает, из какой цены строятся бары. Это индикативные рыночные данные, а не площадка исполнения: ваши ордера исполняются по ценам вашего брокера.
• Время всегда в UTC. Десятичные числа — строки с собственной точностью инструмента, поэтому ничего не теряется при округлении.
• Историю (бары и тики) см. в эндпоинтах выше; реальное время и история используют одни и те же символы и ключи.

Графики, индикаторы, инструменты рисования и ценовые оповещения (сайт)

У каждого тикера есть бесплатный интерактивный график по адресу /price/<ticker>, например /price/EURUSD. Это функции сайта: они не тратят кредиты API, а аккаунт нужен только для сохранения анализов и оповещений.

Впервые с графиками? Изучите каждый индикатор и инструмент рисования простыми словами: идея, формула, применение и пример.

Списки наблюдения, сравнение, мультиграфик и скринер (сайт)

Торговые идеи, профили и подписки (сайт)

Мобильное приложение (iPhone и Android)

Войдите в аккаунт, чтобы получить списки наблюдения с живыми ценами, полный график (все индикаторы, инструменты рисования и мастер паттернов, с вашими сохранёнными анализами), ценовые оповещения в виде уведомлений на телефоне (отметьте push в оповещении; включите уведомления в разделе «Аккаунт» в приложении) и идеи сообщества. Двухфакторный вход работает так же, как на сайте. Каждый телефон, на котором вы вошли, указан в разделе Аккаунт, где из него можно выйти; новый пароль выполняет выход на всех телефонах. Тарифы и пополнения управляются на этом сайте. Удалить аккаунт можно в приложении или здесь, в разделе «Аккаунт».

Пригласить друзей (рефералы)

В разделе Панель → Пригласить друзей находится ваша личная ссылка (/r/your-code; добавьте ?next=/premium или любую страницу этого сайта, чтобы направить людей туда). Тот, кто откроет её и создаст аккаунт в течение 30 дней, привязывается к вам. В течение 12 мес. после его регистрации каждое оплаченное им пополнение (криптовалюта в основных сетях или карта, не менее $5) приносит вам 20%. Кешбэк ждёт 14 дн. на случай возврата, а затем зачисляется на ваш баланс: тратьте его на кредиты API, тарифы или Chart Premium. Его также можно вывести (стейблкоины или PayPal) от $50, с подтверждением по e-mail и проверкой нашей командой. Приглашение самого себя или своего второго аккаунта не засчитывается, и для каждого приглашающего есть месячный лимит.

Партнёрская программа (брокеры и преподаватели)

Компании дают своим клиентам Chart Premium: подайте заявку в разделе Панель → Партнёр; после одобрения вы получите ID партнёра и 5 бесплатных пробных мест (по 14 дн. Pro каждое). Места покупаются пакетами (10, 50, 250) со скидкой 30%, для Pro или Pro+ на 1, 3, 6 или 12 месяцев каждое, с вашего баланса. Каждое место становится одноразовым кодом активации, созданным на странице партнёра или через партнёрский API, при желании с вашей клиентской меткой (хранится в замаскированном виде). Неиспользованные коды можно отменить — место вернётся. Клиенты вводят код на странице Premium.

Мастер паттернов (сайт)

✦ Мастер на графике сканирует свечи текущего таймфрейма и перечисляет найденное — с правилами, которые прошла каждая находка, предложенной сделкой и рисунками, которые можно показать на графике или оставить себе. Это автоматический анализ прошлых цен, а не инвестиционная рекомендация. Как читать находку, её статистику, доверительные интервалы и значимость: руководство по мастеру паттернов.

Chart Premium (сайт)

Графики бесплатны. Chart Premium добавляет больше ресурсоёмких инструментов на 1, 3, 6 или 12 месяцев, с оплатой с того же предоплаченного баланса, что и API (длинные периоды дешевле в месяц).

Тестер стратегий (сайт)

Стратегия на графике тестирует торговую стратегию на прошлых свечах текущего таймфрейма и показывает каждую сделку на графике, прибыль, просадку, долю выигрышей и кривую капитала в сравнении с «купи и держи». Выберите встроенную стратегию и измените её параметры или напишите свою на JavaScript. После входа можно тестировать на истории до 20,000 свечей и сохранять до 50 стратегий. Ваш скрипт выполняется только в браузере, в песочнице без доступа к интернету, вашему аккаунту и этому сайту.

Полное руководство по консоли бэктеста объясняет каждую настройку и результат, весь справочник по скриптам (включая все 71 индикатор в коде) и 11 готовых примеров.

const len = input("Average period", 50, { min: 2, max: 500 });
const avg = ta.sma(close, len);
plot(avg, "SMA " + len, "#2F80ED");

function onBar(i) {
  if (avg[i] == null) return;                       // still warming up
  if (position <= 0 && close[i] > avg[i]) long({ slPct: 2 });
  if (position >= 0 && close[i] < avg[i]) short({ slPct: 2 });
}

Публикация анализов и клубы

Делитесь анализом по ссылке или работайте вместе в клубе — общем рабочем пространстве с чатом и полкой анализов графиков.

Куда приходят оповещения: e-mail, Telegram, телефон, браузер и вебхуки

# Python: check that a webhook really comes from us (Flask example)
import hashlib, hmac, time
from flask import Flask, request, abort
SECRET = b"your-webhook-secret"
app = Flask(__name__)

@app.post("/alerts")
def alerts():
    ts = request.headers.get("X-Alert-Timestamp", "")
    sig = request.headers.get("X-Alert-Signature", "").removeprefix("sha256=")
    good = hmac.new(SECRET, ts.encode() + b"." + request.get_data(), hashlib.sha256).hexdigest()
    if not hmac.compare_digest(sig, good) or abs(time.time() - int(ts or 0)) > 300:
        abort(401)
    alert = request.get_json()
    print(alert)            # your trading bot, Slack, a spreadsheet…
    return "ok"

Лимиты и ошибки (API цен)

Ваш аккаунт: ключи API, безопасность и команды

Кредиты, пополнения и тарифы

Задачи

Тяжёлая работа (сканы паттернов, большие партии кодов, длинные отчёты) ждёт в справедливой очереди, а не замедляет сайт. Панель → Задачи показывает каждую с местом в очереди и ожидаемым временем; страницу можно закрыть — о готовности вы узнаете в панели (а для долгих задач и по e-mail). Неудачная задача автоматически повторяется и никогда не исчезает молча.

Помощь и поддержка

• Обращения в поддержку: пишите нам из панели (со скриншотами); ответы приходят по e-mail и в обращение.
• Спросить ИИ (кнопка чата внизу справа) в любое время отвечает на вопросы о платформе.
• В разделе Обучение объяснён каждый индикатор и инструмент рисования; в блоге есть уроки; список изменений показывает, что нового.
• Статус цены: GET /v1/prices/latest сообщает LIVE, STALE или MARKET_CLOSED для каждой котировки (см. Статус цены).

Индикаторы и рисунки рассчитываются в вашем браузере. Графики, индикаторы и оповещения — это информация, а не инвестиционные рекомендации.