Poll fired alerts
hl_poll_alerts[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Retrieve alert events that fired since your last poll. Default is simple at-most-once delivery (events are marked delivered as soon as they are read — a lost response loses them). For reliable at-least-once delivery, pass reliable=true: events are then redelivered on every poll until you acknowledge them by passing the highest event id you have processed as ackThroughId. Each event includes a signed signal payload verifiable with hl_signal_pubkey. Call periodically to act on the market.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "hl_poll_alerts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| reliable | No | true = at-least-once: events redeliver until acknowledged via ackThroughId. | |
| ackThroughId | No | Acknowledge all events with id <= this value (from a previous reliable poll). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| acked | Yes | ||
| count | Yes | ||
| events | Yes |