---
title: "List all documented trading bots"
method: GET
path: "/api/bots.json"
---

# List all documented trading bots

`GET /api/bots.json`

## Request

- Base URL: `https://getbotornot.com`
- URL: `https://getbotornot.com/api/bots.json`
- Auth: one of:
  - none
  - HTTP bearer

## Query parameters

- `sort` 'name' | 'report_card' | 'warnings'

## Response `200`

Bot list

- object
  - `meta` object
  - `bots` Bot[]
    - `slug` string
    - `name` string
    - `category` string
    - `record_status` 'no_incidents_found' | 'incidents_on_record' | 'shutting_down' | 'discontinued'
    - `report_card` object
      - `result` 'red_flags' | 'closed' | 'caution' | 'limited' | 'clear'
      - `label` string
      - `rules_version` string
      - `drivers` string[]
      - `factors` object[]
        - `rule` string
        - `level` string
        - `text` string
        - `source` string, nullable
    - `custody` 'self_hosted' | 'api_keys' | 'platform' | 'bot_wallet' | 'signals_only' | 'exchange_account' | 'discontinued' | 'other'
    - `official_url` string, nullable
    - `summary` string
    - `pricing` string
    - `pricing_source` string, nullable
    - `exchanges` string[]
    - `connection` string
    - `license` string
    - `red_flags` object[]
      - `text` string
      - `source` string, nullable
    - `impostor_reports` integer
    - `last_checked` string, date
    - `page_url` string
    - `api_url` string

---

[API](https://skmtc.dev/getbotornot/apis/botornot-public-data-api.md) · [All operations](https://skmtc.dev/getbotornot/apis/botornot-public-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getbotornot/apis/botornot-public-data-api/revisions/c3cc3909775d?raw)