---
title: "List all active alerts"
method: GET
path: "/v4/subscription"
tags: ["Subscriptions"]
---

# List all active alerts

`GET /v4/subscription`

/v4/subscription

List all active alerts.

## Query parameters

- `pageSize` number, required
- `offset` number
- `address` string
- `type` SubscriptionType[]
- `chain` string[]
- `status` 'active' | 'paused'

## Response `200`

OK

- SubscriptionV4[]
  - `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.
  - `id` string, required — ID of the alert
  - `timestamp` number — Alert creation time
  - `attr` SubscriptionV4Attributes — Additional attributes based on the alert type.
    - `chain` 'ethereum-sepolia' | 'ethereum-mainnet' | 'ethereum-hoodi' | 'polygon-amoy' | 'polygon-mainnet' | 'kaia-mainnet' | 'kaia-kairos' | 'solana-devnet' | 'solana-mainnet' | 'celo-mainnet' | 'celo-sepolia' | 'lisk-mainnet' | 'lisk-sepolia' | 'algorand-testnet' | 'algorand-mainnet' | 'bitcoin-mainnet' | 'bitcoin-testnet' | 'bitcoin-testnet4' | 'litecoin-mainnet' | 'litecoin-testnet' | 'kucoin-testnet' | 'kucoin-mainnet' | 'cardano-mainnet' | 'cardano-preprod' | 'vechain-testnet' | 'vechain-mainnet' | 'ripple-mainnet' | 'ripple-testnet' | 'xdc-mainnet' | 'xdc-testnet' | 'tron-mainnet' | 'tron-shasta' | 'bsc-mainnet' | 'bsc-testnet' | 'bitcoin-cash-mainnet' | 'bitcoin-cash-testnet' | 'stellar-mainnet' | 'stellar-testnet' | 'multiversx-mainnet' | 'multiversx-testnet' | 'dogecoin-mainnet' | 'dogecoin-testnet' | 'harmony-mainnet-s0' | 'harmony-testnet-s0' | 'eos-mainnet' | 'eos-jungle' | 'avalanche-mainnet' | 'fantom-mainnet' | 'fantom-testnet' | 'arbitrum-one-mainnet' | 'arbitrum-one-sepolia' | 'arbitrum-nova-mainnet' | 'optimism-mainnet' | 'near-mainnet' | 'near-testnet' | 'cronos-mainnet' | 'cronos-testnet' | 'rootstock-mainnet' | 'rootstock-testnet' | 'aurora-mainnet' | 'aurora-testnet' | 'gnosis-mainnet' | 'gnosis-testnet' | 'polkadot-mainnet' | 'polkadot-westend' | 'kusama-mainnet' | 'oasis-mainnet' | 'oasis-emerald' | 'tezos-mainnet' | 'tezos-ghostnet' | 'zcash-mainnet' | 'zcash-testnet' | 'zilliqa-mainnet' | 'zilliqa-testnet' | 'ethereum-classic-mainnet' | 'ethereum-classic-testnet' | 'flare-mainnet' | 'flare-coston' | 'flare-coston2' | 'flare-songbird' | 'haqq-mainnet' | 'haqq-testnet' | 'chiliz-mainnet' | 'chiliz-testnet' | 'base-mainnet' | 'base-sepolia' | 'cosmos-mainnet' | 'cosmos-testnet' | 'iota-mainnet' | 'iota-testnet' | 'casper-mainnet' | 'ton-mainnet' | 'ton-testnet' | 'zksync-mainnet' | 'zksync-sepolia' | 'berachain-mainnet' | 'sonic-mainnet' | 'sonic-blaze' | 'sui-mainnet' | 'sui-testnet' | 'unichain-mainnet' | 'unichain-sepolia' | 'monad-testnet' | 'mocachain-devnet' — Tatum chain identifier.
    - `symbol` string — Ticker of the token to watch. Price alerts are chain-agnostic and USDT-quoted — the tracked pair is always `{symbol}USDT`. Must be one of the symbols supported by the Tatum pricing endpoints (the same set accepted by GET /v4/data/price-change).
    - `percentage` number — PRICE_CHANGE (FIXED/TIMEFRAME) only: move size in percent.
    - `value` number — PRICE_CHANGE (CONSTANT) only: the watched absolute price level.
    - `direction` 'UP' | 'DOWN' | 'BOTH' — Which price movements fire the alert. `BOTH` watches both directions.
    - `referenceType` 'FIXED' | 'TIMEFRAME' | 'CONSTANT' — PRICE_CHANGE only: reference model of the alert.
    - `timeframe` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' — PRICE_CHANGE (TIMEFRAME) only: reference period.
  - `referencePrice` string — PRICE_CHANGE only. FIXED — the price captured at creation; TIMEFRAME — the current period's opening price; CONSTANT — the watched level.
  - `periodStart` number — 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.
  - `paused` number — PRICE_CHANGE only: timestamp (ms) since when the alert is paused.
  - `triggeredAt` number — PRICE_CHANGE only: timestamp (ms) when a one-time (FIXED) alert fired.
  - `note` string — Any other relevant information such as important updates

## Other responses

- `400` — Bad Request
- `401` — Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `500` — Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.net/tatum/apis/blockchain-data.md) · [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/versions/8622ee4b8fae/schema)