# GET /v2/rules

**List your rules**

A rule is a saved `{q, universe_id?, order, dir, fields}` bundle. Rules can be referenced from `/v2/scan?rule=` (one-off run) and `/v2/webhooks` (subscribe to fires). Same SQL grammar as `/v2/scan`.

## Plan access

- **Plan access.** Included on every plan.
- **Rate limit.** Hobby 60/min · Pro 2,000/min · Scale 10,000/min.
- **Capacity.** Hobby 5 · Pro 25 · Scale 100 · Enterprise unlimited.

## Query / path parameters

| Name | In | Type | Required | Description |
|------|----|----|----------|-------------|
| `limit` | query | integer | no | Page size. Max 100. Default: `50`. |
| `cursor` | query | string | no | Opaque cursor. |

## Status codes

- **200** — Page of rules.

## Sample response

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "count": 2,
  "next_cursor": null,
  "rules": [
    {
      "id": "smallcap_breakouts",
      "name": "Small-cap breakouts",
      "description": "Breakouts under $2B market cap",
      "q": "breakout AND market_cap < 2000000000",
      "universe_id": null,
      "order": "day_change_pct",
      "dir": "desc",
      "fields": ["pe_ratio"],
      "created_at": 1778720416,
      "updated_at": 1778720416
    },
    {
      "id": "rsi_oversold_mega",
      "name": "Oversold megacaps",
      "description": "RSI under 30 on the top 100",
      "q": "rsi_oversold",
      "universe_id": "top_100",
      "order": "rsi_14",
      "dir": "asc",
      "fields": [],
      "created_at": 1778550000,
      "updated_at": 1778550000
    }
  ]
}
```

## Examples

### List your saved rules

Request:

```shell
curl https://api.tickerbot.io/v2/rules \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "count": 2,
  "next_cursor": null,
  "rules": [
    {
      "id": "smallcap_breakouts",
      "name": "Small-cap breakouts",
      "description": "Breakouts under $2B market cap",
      "q": "breakout AND market_cap < 2000000000",
      "universe_id": null,
      "order": "day_change_pct",
      "dir": "desc",
      "fields": ["pe_ratio"],
      "created_at": 1778720416,
      "updated_at": 1778720416
    },
    {
      "id": "rsi_oversold_mega",
      "name": "Oversold megacaps",
      "description": "RSI under 30 on the top 100",
      "q": "rsi_oversold",
      "universe_id": "top_100",
      "order": "rsi_14",
      "dir": "asc",
      "fields": [],
      "created_at": 1778550000,
      "updated_at": 1778550000
    }
  ]
}
```

---

Interactive sandbox + parameter editor: https://tickerbot.io/api/endpoints/rules/list