List watches

curl -X POST https://app.apiton.org/v2.Watch/List \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer 123456789:aB3dE…' -d '{}'
# {"watches":[{"id":"41","address":"UQCdqX…","kind":"wallet","name":"UQCdqX…3AF4","min_amount":1,
#   "poll_interval_seconds":180,"created_at":"2026-11-02T12:00:00Z","last_polled_at":"2026-11-02T12:30:00Z",
#   "webhook":{"url":"https://example.com/apiton","state":"failing","last_error":"status 503","pending":2,
#              "last_attempt_at":"2026-11-02T12:29:40Z","last_success_at":"2026-11-02T11:58:03Z",
#              "failing_since":"2026-11-02T12:28:40Z","next_attempt_at":"2026-11-02T12:34:40Z"}}],
#  "limits":{"plan":"free","watches":1,"watch_limit":3,"poll_interval_seconds":180,
#            "webhooks_per_hour":10,"webhooks_this_hour":4}}

Oldest first, the order in which a limit keeps watches running. webhook.state: active,
failing (being retried) or paused (gave up, see below). The secret is never shown again.

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "watches": [
        {
            "id": "string",
            "address": "string",
            "kind": "string",
            "name": "string",
            "status": "string",
            "min_amount": "string",
            "paused": true,
            "poll_interval_seconds": 0,
            "created_at": "2019-08-24T14:15:22.123Z",
            "last_polled_at": "2019-08-24T14:15:22.123Z",
            "webhook": {
                "url": "string",
                "state": "string",
                "last_error": "string",
                "pending": 0,
                "last_attempt_at": "2019-08-24T14:15:22.123Z",
                "last_success_at": "2019-08-24T14:15:22.123Z",
                "failing_since": "2019-08-24T14:15:22.123Z",
                "next_attempt_at": "2019-08-24T14:15:22.123Z"
            }
        }
    ],
    "limits": {
        "plan": "string",
        "watches": 0,
        "watch_limit": 0,
        "poll_interval_seconds": 0,
        "webhooks_per_hour": 0,
        "webhooks_this_hour": 0
    }
}

🔴500Server Error

Request

Request Code Samples

Responses