Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Subscriptions

List all active alerts

/v4/subscription

List all active alerts.

get/v4/subscription

Query parameters

pageSizenumber required
Example:10

Max number of items per page is 50.

offsetnumber

Offset to obtain next page of the data.

addressstring

Value for filtering by address

typeSubscriptionType[]

Filter by alert type. Multiple values can be passed as a comma-separated list.

[
  "ADDRESS_EVENT"
]
chainstring[]

Filter by public chain name. Use chain names such as ethereum-mainnet, not currency symbols such as ETH. Multiple values can be passed as a comma-separated list.

[
  "ethereum-mainnet"
]
status'active' | 'paused'
Example:active

Filter by alert status.

Response

OK

type'ADDRESS_EVENT' | 'CONTRACT_ADDRESS_LOG_EVENT' | 'INCOMING_NATIVE_TX' | 'OUTGOING_NATIVE_TX' | 'OUTGOING_FAILED_TX' | 'PAID_FEE' | 'INCOMING_INTERNAL_TX' | 'OUTGOING_INTERNAL_TX' | 'INCOMING_FUNGIBLE_TX' | 'OUTGOING_FUNGIBLE_TX' | 'INCOMING_NFT_TX' | 'OUTGOING_NFT_TX' | 'INCOMING_MULTITOKEN_TX' | 'OUTGOING_MULTITOKEN_TX' | 'FAILED_TXS_PER_BLOCK' | 'PRICE_CHANGE' required

Type of the alert.

idstring required

ID of the alert

timestampnumber

Alert creation time

referencePricestring

PRICE_CHANGE only. FIXED — the price captured at creation; TIMEFRAME — the current period's opening price; CONSTANT — the watched level.

periodStartnumber

PRICE_CHANGE with referenceType TIMEFRAME only: start (milliseconds, UTC) of the period the current reference price belongs to.

status'ACTIVE' | 'PAUSED' | 'TRIGGERED'

PRICE_CHANGE only: lifecycle state. TRIGGERED — a one-time (FIXED) alert that has already fired; terminal and immutable.

pausednumber

PRICE_CHANGE only: timestamp (ms) since when the alert is paused.

triggeredAtnumber

PRICE_CHANGE only: timestamp (ms) when a one-time (FIXED) alert fired.

notestring

Any other relevant information such as important updates

Example response

[
  {
    "type": "ADDRESS_EVENT",
    "id": "7c21ed165e294db78b95f0f1",
    "timestamp": 1653320900353,
    "attr": {
      "chain": "ethereum-mainnet",
      "symbol": "BTC",
      "direction": "BOTH"
    },
    "referencePrice": "100000",
    "periodStart": 1784678400000
  }
]