---
title: "Add Trading Pair"
method: POST
path: "/market-data/trading-pair/add"
tags: ["Market Data"]
---

# Add Trading Pair

`POST /market-data/trading-pair/add`

Initialize order book for a trading pair.

This endpoint dynamically adds a trading pair to a connector's order book tracker.
It uses the best available connector (trading connectors are preferred over data connectors).

Args:
    request: Request with connector name, trading pair, optional account name, and timeout

Returns:
    TradingPairResponse with success status and message

Raises:
    HTTPException: 500 if initialization fails

## Request body

- AddTradingPairRequest — Request model for adding a trading pair to order book tracking
  - `connector_name` string, required — Name of the connector (e.g., 'binance', 'binance_perpetual')
  - `trading_pair` string, required — Trading pair to add (e.g., 'BTC-USDT')
  - `account_name` string, nullable — Optional account name for trading connector preference
  - `timeout` number — Timeout in seconds for order book initialization

## Response `200`

Successful Response

- TradingPairResponse — Response model for trading pair management operations
  - `success` boolean, required — Whether the operation succeeded
  - `connector_name` string, required — Name of the connector
  - `trading_pair` string, required — Trading pair that was added/removed
  - `message` string, required — Status message

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.net/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/versions/5347fe79537f/schema)