---
title: "List grid bots"
method: GET
path: "/v2/grid/bot"
tags: ["Grid"]
---

# List grid bots

`GET /v2/grid/bot`

List grid bots for the selected master account, owned subaccount, or leader-owned vault.

## Query parameters

- `limit` integer
- `vault_id` string
- `sub_account_id` string, uuid

## Response `200`

Successful response

- ListGridBotsResponse
  - `bots` GridBotView[]
    - `id` string — Grid bot identifier
    - `account_id` string — Account that owns the bot
    - `symbol` string — Trading pair symbol
    - `status` 'CREATED' | 'RUNNING' | 'STOPPING' | 'STOPPED' — Current bot status
    - `mode` 'LONG' | 'SHORT' | 'NEUTRAL' — Grid mode
    - `upper_price` string
    - `lower_price` string
    - `grid_count` integer
    - `leverage` integer
    - `collateral` string
    - `sl_price` string
    - `long_sl_price` string
    - `short_sl_price` string
    - `orders` GridOrderView[]
      - `strategy_id` string — Strategy ID for this grid level
      - `price` string — Entry price for this grid level
      - `tp_price` string — Take-profit price for this grid level
      - `sl_price` string — Stop-loss price for this grid level, when configured
      - `side` string — Entry order side
      - `size` string — Entry order size
      - `filled` boolean — Whether the grid level has filled
      - `entry_order_id` integer — Entry order ID assigned by the matching engine
      - `tp_order_id` integer — Take-profit order ID assigned by the matching engine
      - `sl_order_id` integer — Stop-loss order ID assigned by the matching engine
    - `grid_profit` string — Realized grid profit, when available
    - `created_at_ms` integer
    - `updated_at_ms` integer
  - `count` integer — Number of bots returned

## Other responses

- `401` — Authentication is missing, invalid, or does not own the selected subaccount
- `503` — Grid bot service not configured

---

[API](https://skmtc.net/strikefinance/apis/strike-finance-staking-api.md) · [All operations](https://skmtc.net/strikefinance/apis/strike-finance-staking-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/strikefinance/strike-finance-staking-api/revisions/6b7d8bd51050/schema)