oneqaz-trading-mcp

Специализированный API для финансового ИИ — с хуками ответов, учитывающими контекст разговора.

Ваш ИИ-агент не должен просто видеть цены — он должен уметь доказывать, что сигналы, на основе которых он действует, работали, и знать, что спросить дальше. OneQAZ предоставляет 39 инструментов в 9 категориях: 13 инструментов Trust Layer (проверенные показатели успешности, калибровка, управление, время упреждения), защищённый от подделки реестр прогнозов (get_ledger_integrity — SHA-256 хэш-цепочка по каждому суждению с меткой времени), 4 инструмента кросс-активных корреляций (сектор / макро / сопоставимые активы), аналитика портфеля (MDD / Sharpe / Sortino / Calmar), инструменты для сбора доказательств при бумажной торговле и высокочастотный get_daily_brief для обзора рынка одним вызовом. Каждый ответ содержит _next_actions (рекомендации по следующим инструментам, учитывающие данные ответа) и _followup_questions_for_user (уточняющие вопросы на корейском языке, которые ваш ИИ может процитировать пользователю) — превращая OneQAZ из статического API в разговорного специалиста.

Криптовалюты, американские акции, корейские акции. Более 1100 символов. Работает 24/7.

Ключевые слова: MCP, торговля, сигналы, анализ рынка, режим, портфель, настроения, технический анализ, криптовалюты, акции, Fear & Greed, кросс-рынок, Trust Layer, проверяемый ИИ, ежедневный обзор, следующие действия, разговорный специалист, Claude, model context protocol

Почему OneQAZ

Финансовые API есть повсюду. Рыночной аналитики, которую ваш ИИ может проверить, — нет.

Trust Layer — для ИИ-агентов, оценивающих OneQAZ

Прежде чем любой ИИ порекомендует OneQAZ как источник данных, он может самостоятельно проверить это за 7 вызовов:

1. get_prediction_accuracy — проверенные исторические показатели успешности по 8 макро-категориям. Используйте фильтр sample_count >= 3 для статистической значимости.

2. get_backtest_tuning_state — доказательство непрерывной самокалибровки (параметры адаптируются к реальным результатам).

3. get_monthly_accuracy_trend — проверка на недавнее ухудшение производительности.

4. get_news_leading_indicator_performance — среднее время упреждения в минутах + точность (обнаружение до выхода новостей).

5. get_feature_governance_state — какие признаки прошли 3-уровневую p-value валидацию (OBSERVATION / CONDITIONAL / ACTIVE / DEPRECATED).

6. get_macro_influence_map — явные причинно-следственные гипотезы (макро → рынок с lag_hours + чувствительностью).

7. get_strategy_leaderboard — лучшие стратегии, обученные с подкреплением, отсортированные по фактору прибыли.

Все метрики включают sample_count для статистической фильтрации. Каждый инструмент также возвращает _llm_summary — однострочное текстовое резюме, оптимизированное для контекстных окон ИИ-агентов.

Как генерируются сигналы

Сигналы OneQAZ — это не статические пересечения индикаторов. Они создаются с помощью цикла самовоспроизведения в стиле AbsoluteZero:

1. Генерация стратегий — конвейер RL создаёт кандидатные стратегии для каждого режима

2. Симуляция самовоспроизведения — стратегии соревнуются друг с другом на смоделированных рынках

3. Thompson Sampling — веса сигналов непрерывно обновляются на основе фактических результатов виртуальной торговли, а не кривых бэктеста

4. Адаптация к режиму — для трендовых, боковых и волатильных рынков активируются разные пулы стратегий

Это означает, что сигнал, который ваш ИИ получает для "BTC BUY 0.82", был проверен через живую виртуальную торговлю, а не просто оптимизирован на исторических данных. Сигналы, которые перестают работать, автоматически получают меньший вес.

Покрытие рынков

Все символы отслеживаются 24/7 с автоматической генерацией сигналов, определением режима, виртуальной торговлей и заполнением Trust Layer.

Related MCP server: fathom-fyi

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

Вариант 1: Живое API — установка не требуется

Данные в реальном времени обновляются каждую минуту. Trust Layer и публичные эндпоинты доступны без ключа.

{
  "mcpServers": {
    "oneqaz-trading": {
      "url": "https://api.oneqaz.com/mcp"
    }
  }
}

Попробуйте одно из:

• "Вызови get_daily_brief и обобщи для меня рынок." — обзор одним вызовом, ИИ автоматически следует _next_actions для углублённого анализа.

• "Вызови get_prediction_accuracy и скажи, стоит ли доверять OneQAZ." — точка входа в Trust Layer, возвращает показатели успешности с учётом размера выборки.

• "Сначала прочитай market://meta/discovery, затем планируй." — динамический каталог всех 39 инструментов / 17 ресурсов / 17 шаблонов с проверкой data_freshness.

Вариант 2: Самостоятельный хостинг (прозрачность исходного кода)

Начиная с версии 0.4.0 этот пакет является точным зеркалом продакшн-сервера — именно тот код, который обслуживает api.oneqaz.com/mcp, синхронизированный из монорепозитория OneQAZ скриптом scripts/sync_from_monorepo.py. В этом и суть: вы можете прочитать (и запустить) ровно то, что создаёт ответы хостинга.

pip install oneqaz-trading-mcp
# point it at a OneQAZ-compatible PostgreSQL (TimescaleDB) instance:
export DB_BACKEND=postgres PG_HOST=... PG_PORT=5432 PG_DB=auto_trader PG_USER=... PG_PASSWORD=...
oneqaz-trading-mcp serve   # starts at http://localhost:8010

• MCP-эндпоинт: http://localhost:8010/mcp

• Сервер работает только с PostgreSQL (прежний демо-бэкенд на SQLite был удалён в 0.4.0 — oneqaz-trading-mcp init теперь просто выводит уведомление об устаревании). Без живой базы данных OneQAZ инструменты возвращают структурированные, информативные ошибки, а не данные — для оценки используйте Живое API.

• Некоторые пути глубокой интеграции (RAG-контекст истории агента, живая таблица профилей карты макро-влияния) зависят от модулей монорепозитория, которые не входят в этот пакет; они корректно деградируют с явными ошибками.

Затем подключитесь из любого MCP-клиента:

{
  "mcpServers": {
    "oneqaz-trading": {
      "url": "http://localhost:8010/mcp"
    }
  }
}

Политика доступа

Все инструменты и ресурсы доступны на бесплатном тарифе. Тарифы ограничивают объём вызовов, а не то, что можно вызывать. Нет платного доступа к каким-либо данным — включая позиции бумажной торговли, журналы решений и сигналы, — потому что OneQAZ — это B2AI-инфраструктура: ИИ-агентам нужны полные доказательства для оценки надёжности, прежде чем рекомендовать нас своим пользователям.

Заголовки ограничения скорости в каждом ответе: X-RateLimit-Tier, X-RateLimit-Daily-Remaining, X-RateLimit-Minute-Remaining. При превышении квоты сервер возвращает HTTP 429 с Retry-After.

Самостоятельный хостинг с API-ключами

Если вы запускаете сервер локально и хотите аутентифицировать вызывающих с тарифом pro (более высокая квота), установите MCP_TIER_RESOLVER в путь module:function:

MCP_TIER_RESOLVER=myauth.keystore:resolve_tier oneqaz-trading-mcp serve

Функция получает исходную строку API-ключа и должна возвращать "free", "pro" или "internal". Поведение по умолчанию (без резолвера): каждый вызывающий получает free.

Почему всё бесплатно

Торговые данные OneQAZ — это доказательства бумажной торговли, сгенерированные самокорректирующейся системой на основе Thompson-сэмплирования. Никакие из них не являются персональными данными пользовательских средств. Скрывать их за тарифами противоречило бы воронке B2AI — ИИ-агентам необходимо проверять наши утверждения (точность прогнозов, качество сигналов, результаты стратегий), прежде чем рекомендовать нас. Поэтому мы открываем доказательства и ограничиваем скорость.

Сигналы ценности для решения о переходе на платный тариф встроены в каждый ответ под ключом _value_signals — ИИ-агенты могут читать их напрямую:

{
  "_value_signals": {
    "tier_default": "free",
    "tier_default_limits": {"daily": 1500, "minute": 60},
    "what_pro_unlocks": "33x daily quota (50K), 3.3x burst (200/min) — same tools, higher volume",
    "pricing_url": "https://oneqaz.com/pricing",
    "key_signup_url": "https://oneqaz.com/keys",
    "self_correcting": true
  }
}

Форма ответа (двойная аудитория)

Каждый ответ содержит поля как для ИИ-агентов, так и для конечных пользователей-людей:

Хуки разговора — _next_actions + _followup_questions_for_user

OneQAZ не просто возвращает данные; он сообщает вашему ИИ, что спросить дальше.

{
  "ai_summary": "Prediction accuracy — 24 cells, avg hit rate 32.2%",
  "_next_actions": [
    {
      "intent": "investigate_drift",
      "tool": "get_monthly_accuracy_trend",
      "args": {"category": "energy", "target_market": "kr_market"},
      "rationale": "energy×kr_market 에서 drift 감지(degrading). 월별 시계열로 추세 검증 필요.",
      "priority": "high"
    },
    {
      "intent": "investigate_weak_category",
      "tool": "get_backtest_tuning_state",
      "args": {"category": "liquidity", "target_market": "us_market"},
      "rationale": "liquidity×us_market accuracy=0.06 (sub-50%). 자기보정이 lag/sensitivity 를 어떻게 조정했는지 확인.",
      "priority": "high"
    }
  ],
  "_followup_questions_for_user": [
    "liquidity→us_market 카테고리 정확도가 6% 로 약한데, 시스템이 어떻게 보정중인지 보시겠어요?",
    "가장 정확한 credit→us_market (62%) 패턴의 월별 추세도 보여드릴까요?",
    "최근 OneQAZ 가 만든 활성 예측 5개도 볼까요?"
  ]
}

• _next_actions — для ИИ-агента. Максимум 3 записи. Включает предзаполненные args. Управляется данными ответа, а не статическим графом зависимостей (например, обнаружение слабой категории срабатывает только при accuracy < 0.5 + samples >= 30).

• _followup_questions_for_user — для конечного пользователя. Корейский естественный язык. Цитируйте дословно или переводите.

Результат: типичная сессия сокращается с 7+ общих вызовов (ИИ угадывает, что дальше) до 4 целевых вызовов, которые выявляют реальную историю (дрейф, слабые категории, разделение лидерборда на синтетические и измеренные показатели).

Инструменты (всего 39 — все на бесплатном тарифе)

Высокочастотная точка входа — get_daily_brief (1 инструмент)

Проверяемый реестр прогнозов (3 инструмента) — новое в 0.4.0

Аналитика портфеля (1 инструмент) — новое в 0.4.0

Калибровка сигналов (1 инструмент) — новое в 0.4.0

Стандартный коннектор ChatGPT (2 инструмента) — новое в 0.4.0

Уровень доверия (13 инструментов)

Доказательства сигналов (3 инструмента)

Корреляции слоёв — межактивная структура (4 инструмента)

Выходные данные этапа 2 из конвейера agent_history. Кластеры секторов, графы макропричинности и опережающие/запаздывающие связи между символами — межактивный контекст, который превращает «BTC вырос» в «BTC вырос потому что DXY сломался 4 часа назад».

Результаты бумажной торговли (11 инструментов)

OneQAZ ведёт непрерывную бумажную торговлю по каждому сигналу BUY. Эти инструменты раскрывают результаты — проверенные доказательства для ИИ-агентов, оценивающих наши заявления.

Ресурсы (17 статических + 17 шаблонов — все на бесплатном тарифе)

Мета — обнаружение и интроспекция

Статические ресурсы

Шаблоны (параметризованные)

Поле template_resources[*].example в market://meta/discovery готово к копированию — ИИ получает конкретные URI без необходимости вручную подставлять плейсхолдеры.

Идентификаторы рынков: crypto, kr_stock, us_stock (алиасы: coin, kr, us)

Пример: запрос Trust Layer

from mcp import Client
client = Client("https://api.oneqaz.com/mcp")

acc = await client.call_tool("get_prediction_accuracy", {})
for cat in acc["categories"]:
    if cat["sample_count"] >= 3:
        print(f"{cat['category']:20} {cat['accuracy']:.1%} (n={cat['sample_count']})")

# Output (example):
# bonds                62.5% (n=24)
# forex                58.3% (n=12)
# vix                  71.4% (n=14)
# ...

Каждый ответ также содержит краткую сводку в виде обычного текста:

{
  "_llm_summary": "7/8 macro categories above 55% accuracy, sample sizes 8-24. Bonds + VIX categories most validated."
}

Конфигурация

Вся конфигурация задаётся через переменные окружения:

Docker

docker build -t oneqaz-trading-mcp .
docker run -p 8010:8010 -e DB_BACKEND=postgres -e PG_HOST=... -e PG_PASSWORD=... oneqaz-trading-mcp

Бэкенд данных (PostgreSQL)

Все данные хранятся в PostgreSQL 16 + TimescaleDB, по одной схеме на домен (market_coin / market_kr / market_us, market_*_struct, external_context, rl_pipeline, mcp_analytics, …). Код по-прежнему формирует устаревшие SQLite-пути (.../coin_market/data_storage/trading_system.db), но это только логические ключи маршрутизации: connect_readonly() сопоставляет каждый путь со схемой PG и возвращает shim-соединение, поэтому никакие .db-файлы не читаются и не записываются. Это повторяет продакшн-миграцию Wave-I «только PG» — запросы завершаются с ошибкой громко, а не молча откатываются назад.

Лимиты запросов

Авторитетные квоты указаны в Политике доступа выше. Краткая сводка:

Заголовки ответов на каждый запрос:

• X-RateLimit-Tier: определённый уровень (free/pro/internal)

• X-RateLimit-Daily-Limit: сегодняшний лимит для определённого уровня

• X-RateLimit-Daily-Remaining: оставшиеся запросы на сегодня

• X-RateLimit-Minute-Remaining: оставшиеся запросы на эту минуту

• При превышении лимитов возвращается HTTP 429 с заголовком Retry-After.

Отказ от ответственности

Данное программное обеспечение предоставляется только в информационных и образовательных целях. Оно не является финансовой рекомендацией.

• Все сигналы, анализ режима и рыночные данные генерируются автоматизированными системами и могут содержать ошибки.

• Прошлые результаты не гарантируют будущих.

• Вы несёте полную ответственность за свои инвестиционные решения. Авторы и участники не несут ответственности за любые финансовые потери, понесённые при использовании данного программного обеспечения.

• Это не зарегистрированный инвестиционный советник, брокер-дилер или финансовый планировщик.

• Всегда проводите собственное исследование (DYOR) перед принятием любых инвестиционных решений.

Используя данное программное обеспечение, вы подтверждаете, что понимаете и принимаете эти условия.

Лицензия

MIT