Skip to content

Martingale42/nautilus-dev / skills/nt-adapters

nt-adapters

Verified

Use when working with exchange or data provider adapters, HTTP/WebSocket clients, instrument providers, or venue integration in NautilusTrader.

FileKindSize
SKILL.mdskill md8.5 KB
references/api/.gitkeepother0 B
references/api/adapters/betfair.mdmarkdown1.9 KB
references/api/adapters/binance.mdmarkdown2.4 KB
references/api/adapters/bybit.mdmarkdown1.2 KB
references/api/adapters/databento.mdmarkdown1.4 KB
references/api/adapters/dydx.mdmarkdown1011 B
references/api/adapters/index.mdmarkdown291 B
references/api/adapters/interactive_brokers.mdmarkdown2.2 KB
references/api/adapters/okx.mdmarkdown1004 B
references/api/adapters/polymarket.mdmarkdown1.2 KB
references/api/adapters/tardis.mdmarkdown1021 B
references/api/live.mdmarkdown1.1 KB
references/concepts/.gitkeepother0 B
references/concepts/adapters.mdmarkdown5.9 KB
references/concepts/live.mdmarkdown44.3 KB
references/examples/.gitkeepother0 B
references/examples/architect_ax/ax_book_imbalance.pyscript4.0 KB
references/examples/architect_ax/ax_data_tester.pyexecutablescript3.7 KB
references/examples/architect_ax/ax_exec_tester.pyexecutablescript4.6 KB
references/examples/architect_ax/ax_mean_reversion.pyscript4.0 KB
references/examples/betfair/betfair.pyscript6.8 KB
references/examples/binance/binance_data_tester.pyscript3.6 KB
references/examples/binance/binance_futures_demo_exec_tester.pyscript6.5 KB
references/examples/binance/binance_futures_testnet_exec_tester.pyscript6.8 KB
references/examples/binance/binance_spot_and_futures_market_maker.pyscript6.8 KB
references/examples/binance/binance_spot_demo_exec_tester.pyscript4.3 KB
references/examples/binance/binance_spot_ema_cross_bracket_algo.pyscript4.4 KB
references/examples/binance/binance_spot_exec_tester.pyscript4.9 KB
references/examples/binance/binance_spot_testnet_exec_tester.pyscript4.3 KB
references/examples/bitmex/bitmex_data_tester.pyscript4.0 KB
references/examples/bitmex/bitmex_exec_tester.pyscript5.9 KB
references/examples/bybit/README_options_data_collector.mdmarkdown6.3 KB
references/examples/bybit/bybit_data_tester.pyscript4.1 KB
references/examples/bybit/bybit_ema_cross.pyscript4.9 KB
references/examples/bybit/bybit_ema_cross_bracket_algo.pyscript5.3 KB
references/examples/bybit/bybit_ema_cross_stop_entry.pyscript4.7 KB
references/examples/bybit/bybit_ema_cross_with_trailing_stop.pyscript4.7 KB
references/examples/bybit/bybit_exec_tester.pyscript8.9 KB
references/examples/bybit/bybit_options_data_collector.pyscript32.5 KB
references/examples/bybit/bybit_request_custom_endpoint.pyscript4.9 KB
references/examples/databento/databento_data_tester.pyscript4.3 KB
references/examples/databento/notebooks/databento_historical_data.pyscript6.9 KB
references/examples/deribit/deribit_data_tester.pyscript5.0 KB
references/examples/deribit/deribit_exec_tester.pyscript5.3 KB
references/examples/dydx/dydx_data_tester.pyscript4.0 KB
references/examples/dydx/dydx_exec_tester.pyscript6.9 KB
references/examples/dydx/dydx_market_maker.pyscript4.8 KB
references/examples/hyperliquid/hyperliquid_data_tester.pyscript4.4 KB
references/examples/hyperliquid/hyperliquid_exec_tester.pyscript6.6 KB
references/examples/interactive_brokers/connect_with_dockerized_gateway.pyscript5.7 KB
references/examples/interactive_brokers/connect_with_tws.pyscript4.9 KB
references/examples/interactive_brokers/contract_download.pyscript1.2 KB
references/examples/interactive_brokers/historical_download.pyscript4.3 KB
references/examples/interactive_brokers/notebooks/bracket_order_example.pyscript8.6 KB
references/examples/interactive_brokers/notebooks/oca_group_example.pyscript9.0 KB
references/examples/interactive_brokers/notebooks/simple_conditions_example.pyscript14.2 KB
references/examples/interactive_brokers/notebooks/spread_example.pyscript14.5 KB
references/examples/interactive_brokers/notebooks/with_databento_instrument_id_example.pyscript13.4 KB
references/examples/interactive_brokers/with_databento_client.pyscript4.5 KB
references/examples/kraken/kraken_data_tester.pyscript4.6 KB
references/examples/kraken/kraken_exec_tester.pyscript6.6 KB
references/examples/okx/okx_data_tester.pyscript6.1 KB
references/examples/okx/okx_exec_tester.pyscript11.2 KB
references/examples/okx/okx_spot_swap_quoter.pyscript19.2 KB
references/examples/polymarket/polymarket_data_tester.pyscript4.5 KB
references/examples/polymarket/polymarket_exec_tester.pyscript8.3 KB
references/examples/polymarket/polymarket_slug_builder_tester.pyscript4.0 KB
references/examples/polymarket/slug_builders.pyscript4.0 KB
references/examples/rust_adapters/architect_ax/node_data_tester.rsscript3.3 KB
references/examples/rust_adapters/architect_ax/node_exec_tester.rsscript3.6 KB
references/examples/rust_adapters/binance/futures/node_data_tester.rsscript2.8 KB
references/examples/rust_adapters/binance/futures/node_exec_tester.rsscript3.9 KB
references/examples/rust_adapters/binance/spot/node_data_tester.rsscript2.8 KB
references/examples/rust_adapters/binance/spot/node_exec_tester.rsscript3.7 KB
references/examples/rust_adapters/bitmex/node_data_tester.rsscript2.9 KB
references/examples/rust_adapters/bitmex/node_exec_tester.rsscript3.4 KB
references/examples/rust_adapters/bitmex/node_grid_mm.rsscript3.5 KB
references/examples/rust_adapters/blockchain/node_data_tester.rsscript11.0 KB
references/examples/rust_adapters/bybit/node_data_tester.rsscript2.7 KB
references/examples/rust_adapters/bybit/node_exec_tester.rsscript3.4 KB
references/examples/rust_adapters/databento/node_data_tester.rsscript7.1 KB
references/examples/rust_adapters/deribit/node_data_tester.rsscript3.2 KB
references/examples/rust_adapters/deribit/node_exec_tester.rsscript4.0 KB
references/examples/rust_adapters/dydx/node_data_tester.rsscript2.8 KB
references/examples/rust_adapters/dydx/node_exec_tester.rsscript3.8 KB
references/examples/rust_adapters/dydx/node_grid_mm.rsscript3.4 KB
references/examples/rust_adapters/hyperliquid/node_data_tester.rsscript3.0 KB
references/examples/rust_adapters/hyperliquid/node_exec_tester.rsscript3.9 KB
references/examples/rust_adapters/kraken/node_data_tester.rsscript4.2 KB
references/examples/rust_adapters/kraken/node_exec_tester.rsscript4.8 KB
references/examples/rust_adapters/okx/node_data_tester.rsscript2.9 KB
references/examples/rust_adapters/okx/node_exec_tester.rsscript4.1 KB
references/examples/rust_adapters/sandbox/databento_cme.rsscript4.8 KB
references/examples/rust_adapters/tardis/node_data_tester.rsscript3.0 KB
references/examples/shioaji/__init__.pyscript0 B
references/examples/shioaji/shioaji_data_tester.pyscript2.1 KB
references/examples/shioaji/shioaji_exec_tester.pyscript3.8 KB
references/examples/tardis/tardis_data_tester.pyscript4.8 KB
references/guides/.gitkeepother0 B
references/guides/adapters.mdmarkdown91.6 KB
references/guides/coding_standards.mdmarkdown6.8 KB
references/guides/ffi.mdmarkdown6.1 KB
references/guides/rust.mdmarkdown41.1 KB
references/guides/spec_data_testing.mdmarkdown34.6 KB
references/guides/spec_exec_testing.mdmarkdown79.2 KB
references/integrations/.gitkeepother0 B
references/integrations/architect_ax.mdmarkdown19.3 KB
references/integrations/betfair.mdmarkdown26.3 KB
references/integrations/binance.mdmarkdown40.6 KB
references/integrations/bitmex.mdmarkdown45.0 KB
references/integrations/blockchain.mdmarkdown4.9 KB
references/integrations/bybit.mdmarkdown30.6 KB
references/integrations/databento.mdmarkdown36.5 KB
references/integrations/deribit.mdmarkdown26.0 KB
references/integrations/dydx.mdmarkdown35.4 KB
references/integrations/hyperliquid.mdmarkdown19.9 KB
references/integrations/ib.mdmarkdown73.2 KB
references/integrations/index.mdmarkdown5.7 KB
references/integrations/kraken.mdmarkdown24.0 KB
references/integrations/okx.mdmarkdown32.1 KB
references/integrations/polymarket.mdmarkdown36.9 KB
references/integrations/tardis.mdmarkdown33.6 KB
templates/.gitkeepother0 B
templates/data_provider.pyscript5.2 KB
templates/exchange.pyscript7.6 KB

templates/exchange.py

View on GitHub
# -------------------------------------------------------------------------------------------------
#  NautilusTrader Exchange Adapter Template
#
#  Use this template for full exchange adapters (data + execution).
#  Components: DataClient + ExecClient + InstrumentProvider + Factories + Config
# -------------------------------------------------------------------------------------------------

from nautilus_trader.common.config import NautilusConfig
from nautilus_trader.live.data_client import LiveMarketDataClient
from nautilus_trader.live.execution_client import LiveExecutionClient
from nautilus_trader.live.factories import LiveDataClientFactory
from nautilus_trader.live.factories import LiveExecClientFactory
from nautilus_trader.model.identifiers import AccountId
from nautilus_trader.model.identifiers import InstrumentId
from nautilus_trader.model.identifiers import Venue


VENUE = Venue("MYEXCHANGE")


# ---------------------------------------------------------------------------
# Configuration
# ---------------------------------------------------------------------------

class MyExchangeDataClientConfig(NautilusConfig, frozen=True):
    """Configuration for MyExchange data client."""

    api_key: str = ""
    api_secret: str = ""
    base_url: str = "https://api.myexchange.com"
    ws_url: str = "wss://stream.myexchange.com"
    # TODO: Add exchange-specific config fields


class MyExchangeExecClientConfig(NautilusConfig, frozen=True):
    """Configuration for MyExchange execution client."""

    api_key: str = ""
    api_secret: str = ""
    base_url: str = "https://api.myexchange.com"
    ws_url: str = "wss://stream.myexchange.com"
    # TODO: Add exchange-specific config fields


# ---------------------------------------------------------------------------
# Instrument Provider (shared by data + exec clients)
# ---------------------------------------------------------------------------

from nautilus_trader.common.providers import InstrumentProvider


class MyExchangeInstrumentProvider(InstrumentProvider):
    """Provides instrument definitions from MyExchange."""

    def __init__(self, client, config=None):
        super().__init__(config=config)
        self._client = client

    async def load_all_async(self, filters=None):
        """Load all tradable instruments from exchange."""
        # TODO: Fetch instrument info from exchange API
        # Parse into NT instrument types (CryptoPerpetual, CurrencyPair, etc.)
        # self.add(instrument)
        pass

    async def load_ids_async(self, instrument_ids: list[InstrumentId], filters=None):
        """Load specific instruments by ID."""
        pass


# ---------------------------------------------------------------------------
# Data Client
# ---------------------------------------------------------------------------

class MyExchangeDataClient(LiveMarketDataClient):
    """Market data client for MyExchange."""

    def __init__(self, loop, client, msgbus, cache, clock, instrument_provider, config):
        super().__init__(
            loop=loop,
            client_id=None,
            venue=VENUE,
            msgbus=msgbus,
            cache=cache,
            clock=clock,
            instrument_provider=instrument_provider,
            config=config,
        )
        self._client = client

    async def _connect(self):
        await self._instrument_provider.load_all_async()
        # TODO: Connect WebSocket for streaming data

    async def _disconnect(self):
        # TODO: Close WebSocket connections
        pass

    async def _subscribe_trade_ticks(self, instrument_id: InstrumentId):
        # TODO: Subscribe to trade stream via WebSocket
        pass

    async def _subscribe_quote_ticks(self, instrument_id: InstrumentId):
        # TODO: Subscribe to orderbook/quote stream
        pass

    async def _subscribe_order_book_deltas(self, instrument_id: InstrumentId, **kwargs):
        # TODO: Subscribe to order book delta stream
        pass

    async def _unsubscribe_trade_ticks(self, instrument_id: InstrumentId):
        pass

    async def _unsubscribe_quote_ticks(self, instrument_id: InstrumentId):
        pass


# ---------------------------------------------------------------------------
# Execution Client
# ---------------------------------------------------------------------------

class MyExchangeExecClient(LiveExecutionClient):
    """Execution client for MyExchange."""

    def __init__(self, loop, client, msgbus, cache, clock, instrument_provider, config):
        super().__init__(
            loop=loop,
            client_id=None,
            venue=VENUE,
            oms_type=None,  # Set from venue config
            account_type=None,  # Set from venue config
            base_currency=None,
            msgbus=msgbus,
            cache=cache,
            clock=clock,
            instrument_provider=instrument_provider,
            config=config,
        )
        self._client = client

    async def _connect(self):
        # TODO: Connect to execution WebSocket, authenticate
        # Fetch account state:
        #   self._handle_account_state(account_state)
        pass

    async def _disconnect(self):
        # TODO: Close execution connections
        pass

    async def _submit_order(self, command):
        """Submit order to exchange."""
        order = command.order
        # TODO: Convert NT order to exchange format
        # TODO: Send via HTTP API
        # TODO: Handle response, generate OrderAccepted/OrderRejected event
        #   self._handle_event(order_accepted_event)
        pass

    async def _cancel_order(self, command):
        """Cancel order on exchange."""
        # TODO: Send cancel request
        # TODO: Handle response, generate OrderCanceled event
        pass

    async def _modify_order(self, command):
        """Modify order on exchange."""
        # TODO: Send modify request (if exchange supports)
        pass

    async def generate_order_status_report(self, instrument_id, client_order_id, venue_order_id):
        """Generate order status report for reconciliation."""
        # TODO: Query exchange for order status
        pass

    async def generate_fill_reports(self, instrument_id, venue_order_id, start=None):
        """Generate fill reports for reconciliation."""
        # TODO: Query exchange for fill history
        pass

    async def generate_position_status_reports(self, instrument_id=None, start=None):
        """Generate position reports for reconciliation."""
        # TODO: Query exchange for positions
        pass


# ---------------------------------------------------------------------------
# Factories
# ---------------------------------------------------------------------------

class MyExchangeLiveDataClientFactory(LiveDataClientFactory):
    """Factory for creating MyExchange data clients."""

    @staticmethod
    def create(loop, name, config, msgbus, cache, clock):
        client = None  # TODO: Create HTTP/WS client
        provider = MyExchangeInstrumentProvider(client=client)
        return MyExchangeDataClient(
            loop=loop, client=client, msgbus=msgbus, cache=cache,
            clock=clock, instrument_provider=provider, config=config,
        )


class MyExchangeLiveExecClientFactory(LiveExecClientFactory):
    """Factory for creating MyExchange execution clients."""

    @staticmethod
    def create(loop, name, config, msgbus, cache, clock):
        client = None  # TODO: Create HTTP/WS client
        provider = MyExchangeInstrumentProvider(client=client)
        return MyExchangeExecClient(
            loop=loop, client=client, msgbus=msgbus, cache=cache,
            clock=clock, instrument_provider=provider, config=config,
        )
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall