Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Subscriptions

Get alert by ID

/v4/subscription/{id}

Get alert by ID.

get/v4/subscription/{id}

Path parameters

idstring required
Example:5e68c66581f2ee32bc354087

Alert ID

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
}