Create a standing alert
hl_create_alert[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Register a persistent alert the server evaluates on a schedule; fired events are retrieved with hl_poll_alerts. Types: funding_apr (|annualized funding| crosses a threshold), price_move (|return| over a window), whale_net_flip (cohort net position flips long/short). Turns the server into a market watcher for your agent. Analytics only, not investment advice.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"type": "<type>",
"coin": "<coin>"
},
"name": "hl_create_alert"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coin | Yes | Perp coin symbol the alert watches. | |
| type | Yes | ||
| cohort | No | whale_net_flip: up to 100 0x addresses (else HL_WHALE_ADDRESSES). | |
| movePct | No | price_move: |return| fraction (0.05 = 5%, min 0.01). | |
| aprThreshold | No | funding_apr: |APR| fraction (0.5 = 50%). | |
| windowMinutes | No | price_move lookback window. | |
| cooldownMinutes | No | Min gap between re-fires. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| coin | Yes | ||
| type | Yes | ||
| cooldownMinutes | Yes |