Как добавить коннектор новой биржи

В этой статье: как добавить новый connector биржи и где находятся точки интеграции.

Важно:

• коннекторы подключаются через tradejs.config.ts через поле connectors
• connector plugin должен экспортировать connectorEntries
• CLI/runtime резолвит провайдеры и connector names из объединенного реестра (built-in + plugins)

1. Реализуйте Connector Creator

Реализуйте коннектор в своем модуле/пакете (например, @your-scope/tradejs-connectors) и верните полный типизированный контракт Connector.

Минимальный typed-скелет:

import type {
  Connector,
  ConnectorCreator,
  KlineRequest,
  KlineChartData,
  Ticker,
  Position,
  Order,
  Tp,
  Sl,
} from '@tradejs/types';

const kline = async (options: KlineRequest): Promise<KlineChartData> => {
  return [];
};

const getTickers = async (): Promise<Ticker[]> => {
  return [];
};

const getPosition = async (symbol: string): Promise<Position | null> => {
  return null;
};

const getPositions = async (): Promise<Position[]> => {
  return [];
};

const placeOrder = async (
  order: Order,
  tp?: Tp[],
  slPrice?: Sl,
): Promise<boolean> => {
  return true;
};

const closePosition = async (order: Omit<Order, 'qty'>): Promise<boolean> => {
  return true;
};

export const MyExchangeConnectorCreator: ConnectorCreator = async ({
  userName,
}) => {
  const connector: Connector = {
    kline,
    getTickers,
    getPosition,
    getPositions,
    placeOrder,
    closePosition,
    getState: async () => ({}),
    setState: async (_state: object) => {},
  };

  return connector;
};

Обязательные методы Connector:

• kline
• getTickers
• getPosition, getPositions
• placeOrder, closePosition
• getState, setState

2. Экспортируйте connector plugin entries

В вашем пакете коннекторов экспортируйте connectorEntries:

import { defineConnectorPlugin } from '@tradejs/core/config';
import type { ConnectorRegistryEntry } from '@tradejs/types';

import { MyExchangeConnectorCreator } from './myExchangeConnector';

const connectorEntries: ConnectorRegistryEntry[] = [
  {
    name: 'MyExchange',
    providers: ['myexchange', 'mx'],
    creator: MyExchangeConnectorCreator,
  },
];

export default defineConnectorPlugin({ connectorEntries });

Затем подключите пакет в корневом конфиге:

import { defineConfig } from '@tradejs/core/config';
import { basePreset } from '@tradejs/base';

export default defineConfig(basePreset, {
  connectors: ['@your-scope/tradejs-connectors'],
});

3. Обновления типов

Если провайдер должен быть user-facing в фильтрах/конфигах, обновите union в:

• @tradejs/types (Provider)

4. Точки интеграции в CLI

Уже работают через map провайдеров и plugin-реестр:

• команда backtest в @tradejs/cli
• команда continuity в @tradejs/cli

Остаются архитектурно фиксированные места:

• в backtest.ts и signals.ts дополнительно грузятся BTC reference данные из Binance/Coinbase для spread/correlation веток
• results.ts --coverage использует вселенную тикеров ByBit для denominator

Поэтому добавить connector для обычной market-history интеграции просто, но часть потоков по дизайну пока привязана к Binance/Coinbase/ByBit.

5. Рекомендуемый checklist проверки

1. Прогоните TypeScript-проверки в вашем проекте connector.
2. Прогоните unit-тесты в вашем проекте connector.
3. npx @tradejs/cli backtest --updateOnly --connector <provider> --config <Strategy:Config> --timeframe 15
4. npx @tradejs/cli continuity --provider <provider> --timeframe 15 --tickers BTCUSDT
5. npx @tradejs/cli backtest --connector <provider> --config <Strategy:Config> --tests 20

6. Опциональный следующий шаг

Если хотите еще меньше точек входа при добавлении connector, вынесите BTC reference providers и coverage universe в настраиваемые provider settings вместо фиксированных Binance/Coinbase/ByBit.