# Blockscout Watchlist Transactions Feed

> Blockscout Watchlist Transactions Feed is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-10).

Returns a list of recent transactions on a specified blockchain network that involve addresses in the user's watchlist

## Facts

- Endpoint: GET https://api.blockscout.com/%7Bchain_id%7D/api/v2/main-page/transactions/watchlist
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-watchlist-transactions-feed-6b8f9414
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zRjgM7vhiHqLBeXqBRz5O

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-watchlist-transactions-feed-6b8f9414
```

Example prompt: Pull the latest watchlist transactions for my tracked addresses on Ethereum mainnet (chain ID 1) using Blockscout and tell me if anything notable happened in the last few blocks.

## When to prefer this

Use this endpoint when you need to monitor or audit recent on-chain transactions specifically for a pre-configured watchlist of addresses on a given blockchain network. It is ideal for wallet tracking dashboards, security monitoring agents, and portfolio managers that need real-time awareness of activity across watched addresses on a specific chain. Prefer this over generic transaction search when the user cares about a curated set of addresses rather than arbitrary on-chain lookups.

## Known failure modes

- Invalid or unsupported chain_id returns 404 or empty response
- Unauthenticated request returns 402 payment required
- Empty watchlist returns an empty array
- Rate limiting or network timeout on high-traffic chains
- Malformed chain_id path parameter causes 400 bad request

## How this service works

Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data

## Output

Returns an array of transaction objects for the user's watchlist on the specified chain, each including transaction hash, sender and recipient address details (with ENS names, tags, scam flags, proxy type, public/private tags, watchlist names), fee breakdown, gas used and limit, block number, timestamp, confirmation count, token transfer details (including ERC-20/ERC-721 token metadata), decoded input data, exchange rate, revert reason, and chain-specific fields such as Arbitrum batch and message data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "to": {},
   "fee": {
    "type": "string",
    "value": "string"
   },
   "from": {
    "hash": "string",
    "name": "string",
    "is_scam": true,
    "metadata": {},
    "proxy_type": "string",
    "reputation": "string",
    "is_contract": true,
    "is_verified": true,
    "public_tags": [
     {
      "label": "string",
      "address_hash": "string",
      "display_name": "string"
     }
    ],
    "private_tags": [
     {
      "label": "string",
      "address_hash": "string",
      "display_name": "string"
     }
    ],
    "ens_domain_name": "string",
    "implementations": [
     {
      "name": "string",
      "address_hash": "string"
     }
    ],
    "watchlist_names": [
     {
      "label": "string",
      "display_name": "string"
     }
    ]
   },
   "hash": "string",
   "type": 0,
   "nonce": 0,
   "value": "string",
   "method": "string",
   "result": {},
   "status": "string",
   "arbitrum": {
    "status": "string",
    "poster_fee": "string",
    "network_fee": "string",
    "batch_number": 0,
    "gas_used_for_l1": "string",
    "gas_used_for_l2": "string",
    "contains_message": "string",
    "batch_data_container": "string",
    "message_related_info": {
     "message_id": 0,
     "message_status": "string",
     "associated_l1_transaction_hash": "string"
    },
    "commitment_transaction": {
     "hash": "string",
     "status": "string",
     "timestamp": "string"
    },
    "confirmation_transaction": {
     "hash": "string",
     "status": "string",
     "timestamp": "string"
    }
   },
   "gas_used": "string",
   "position": 0,
   "gas_limit": "string",
   "gas_price": "string",
   "raw_input": "string",
   "timestamp": "string",
   "block_number": 0,
   "priority_fee": "string",
   "confirmations": 0,
   "decoded_input": {},
   "exchange_rate": "string",
   "revert_reason": {},
   "max_fee_per_gas": "string",
   "token_transfers": [
    {
     "to": {
      "hash": "string",
      "name": "string",
      "is_scam": true,
      "metadata": {},
      "proxy_type": "string",
      "reputation": "string",
      "is_contract": true,
      "is_verified": true,
      "public_tags": [
       {
        "label": "string",
        "address_hash": "string",
        "display_name": "string"
       }
      ],
      "private_tags": [
       {
        "label": "string",
        "address_hash": "string",
        "display_name": "string"
       }
      ],
      "ens_domain_name": "string",
      "i
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-watchlist-transactions-feed-6b8f9414/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)