List all bots

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

Every bot across all of this partner’s end-users, sorted by bot_id and paged by a keyset cursor. Each row carries the end-user that owns it. Use GET /v1/partner/users/{user_id}/bots to scope to a single end-user. Same conventions as the rest of /v1 - snake_case enums, string decimals.

Requires the partner scope.

Query parameters

Parameter	Type	Required	Description
limit	integer	no	Page size, 1–500. Defaults to 100.
cursor	string	no	Opaque cursor from a previous response’s next_cursor.

Example request

curl "https://rest.haasapi.com/v1/partner/bots?limit=100" \
  -H "Authorization: Bearer hk_live_YOUR_KEY"

Response

200 OK. Returns a PartnerBotsPage.

{
  "data": [
    {
      "bot_id": "7b90995d7434433f81cb652d7bc0ce25",
      "user_id": "8f14e45f-ceea-467a-9c9a-2b0f1d6a3c77",
      "status": "running",
      "type": "spot_grid",
      "exchange": "BINANCE",
      "master_bot_id": null,
      "created_at": "2026-08-28T19:04:11Z",
      "profit": "128.44",
      "roi": "0.062",
      "cloned": 0,
      "followers": 0,
      "config": {
        "symbol": "BTC_USDT",
        "lower_limit": 25000,
        "upper_limit": 35000,
        "grid_count": 20,
        "investment_asset": "USDT",
        "investment_amount": 500
      }
    }
  ],
  "next_cursor": null
}

Fields

PartnerBotsPage

Field	Type	Description
data	array of PartnerBot	One page of the end-user’s bots, sorted by bot_id.
next_cursor	string, nullable	Pass as cursor to fetch the next page; null on the last page. Opaque - never construct or decode one.

PartnerBot

Field	Type	Description
bot_id	string	The bot identifier.
user_id	string	The end-user that owns this bot.
status	BotStatus	Whether the bot is currently running or stopped.
type	WhiteLabelScriptType	The strategy type the bot runs.
exchange	string, nullable	Exchange the bot trades on.
master_bot_id	string, nullable	The master bot this one copies, if it is a copy; null for an original bot.
created_at	string	When the bot was created. RFC 3339 UTC.
profit	string (decimal)	Realized profit in the quote currency, as a decimal string.
roi	string (decimal)	Return on investment as a decimal string (0.15 = 15%).
cloned	integer (int32)	How many times this bot has been copied.
followers	integer (int32)	Copies currently following this bot’s updates.
config	object, nullable	The bot’s current strategy configuration, keyed by the same snake_case keys create and edit take (see GET /v1/partner/strategies). Read it to pre-fill an edit, then send the changed keys back to PUT …/bots/{bot_id}. Null when the bot has no stored config.

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"
}