List available markets

GET https://rest.haasapi.com/v1/partner/markets

Returns the tradable markets across your enabled exchanges. The market_tag is what you pass as symbol in a bot’s config.

Requires the partner scope.

Example request

curl "https://rest.haasapi.com/v1/partner/markets" \
  -H "Authorization: Bearer hk_live_YOUR_KEY"

Response

200 OK. Returns a PartnerMarkets.

{
  "data": [
    {
      "market_tag": "BINANCE_BTC_USDT",
      "exchange": "BINANCE",
      "name": "BTC/USDT",
      "full_name": "Binance BTC/USDT",
      "exchange_symbol": "BTCUSDT",
      "base_currency": "BTC",
      "quote_currency": "USDT",
      "price_decimals": 2,
      "amount_decimals": 6,
      "min_trade_amount": "0.00001",
      "min_trade_volume": "5",
      "amount_label": "BTC",
      "profit_label": "USDT",
      "is_spot": true,
      "is_leverage": false,
      "is_open": true
    }
  ]
}

Fields

PartnerMarkets

Field	Type	Description
`data`	array of PartnerMarket	The markets you can create bots on, sorted by market tag.

PartnerMarket

Field	Type	Description
`market_tag`	string	The market identifier - pass it as `symbol` in a bot’s config.
`exchange`	string
`name`	string
`full_name`	string, nullable
`exchange_symbol`	string, nullable	The exchange’s own symbol for this market.
`base_currency`	string
`quote_currency`	string
`price_decimals`	integer (int32)
`amount_decimals`	integer (int32)
`min_trade_amount`	string (decimal)
`min_trade_volume`	string (decimal)
`amount_label`	string, nullable
`profit_label`	string, nullable
`is_spot`	boolean
`is_leverage`	boolean
`is_open`	boolean	Whether the market is currently trading.

Errors

All errors are RFC 9457 problem documents.

Status	Description
`400`	The request is malformed (invalid limit, unusable cursor, …). (`code: invalid_request`)
`401`	Missing, malformed, disabled, or revoked API key. (`code: invalid_api_key`)
`500`	An unexpected error inside the API. Nothing about the request caused it; retry, and quote the instance value if it persists. (`code: internal_error`)
`502`	An internal service answered in a way the API could not serve. Retry. (`code: upstream_error`)
`503`	The request could not be served right now. Retry with the same key - do not discard it. (`code: temporarily_unavailable`)
`504`	An internal service did not answer within the deadline. Retry with backoff. (`code: upstream_timeout`)

{
  "type": "https://docs.haasapi.com/errors/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "detail": "The request is malformed (invalid limit, unusable cursor, …).",
  "code": "invalid_request"
}