Skip to content

list_alert_rules ​

Read · Sign-in needed

List your alert rules

Returns the alert rules owned by the signed-in wallet, newest first, each with its token, alert type, threshold, cooldown and whether it is enabled. Use it before creating a rule (to avoid a duplicate) and to find a rule's id for update, toggle or delete. Optionally narrow to one token with BOTH chainId and tokenAddress. Common mistakes: sending symbol (refused with 400 invalid_filter, because one ticker can name several tokens), or sending only one of the pair. Rules belong to the wallet you signed in with, not to the whole account: a rule made from another linked wallet is not listed here.

Reads or changesReads only
Sign-inYes
Scopeapi:read
CallsGET /api/v2/alerts/rules (API Explorer)

Input ​

JSON Schema, as the server serves it.

json
{
  "additionalProperties": false,
  "properties": {
    "chainId": {
      "description": "Narrow to one token. Chain key (`base`), numeric id or CAIP-2 id. Send together with `tokenAddress`.",
      "examples": [
        "base"
      ],
      "type": "string"
    },
    "tokenAddress": {
      "description": "Narrow to one token (0x address on EVM, mint on Solana). Send together with `chainId`.",
      "type": "string"
    }
  },
  "type": "object"
}

Example ​

A tools/call request:

json
{
  "name": "list_alert_rules",
  "arguments": {}
}

All MCP tools · Connect an AI app