{"uid":"cap_zRjgM7vhiHqLBeXqBRz5O","slug":"blockscout-watchlist-transactions-feed-6b8f9414","name":"Blockscout Watchlist Transactions Feed","description":"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","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/main-page/transactions/watchlist","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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","implementations":[{"name":"string","address_hash":"string"}],"watchlist_names":[{"label":"string","display_name":"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"}]},"type":"string","token":{"name":"string","type":{},"symbol":"string","decimals":"string","icon_url":"string","reputation":"string","volume_24h":"string","bridge_type":"string","address_hash":"string","total_supply":"string","exchange_rate":"string","holders_count":"string","foreign_address":"string","origin_chain_id":"string","circulating_supply":"string","circulating_market_cap":"string"},"total":{},"method":"string","log_index":0,"timestamp":"string","block_hash":"string","token_type":"string","block_number":0,"transaction_hash":"string"}],"transaction_tag":"string","base_fee_per_gas":"string","created_contract":{},"is_pending_update":true,"transaction_types":["string"],"authorization_list":[{"r":"string","s":"string","v":0,"nonce":"string","status":"string","chain_id":0,"authority":"string","address_hash":"string"}],"fhe_operations_count":0,"confirmation_duration":[0],"transaction_burnt_fee":"string","historic_exchange_rate":"string","max_priority_fee_per_gas":"string","token_transfers_overflow":true,"has_error_in_internal_transactions":true}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_t3rp3PyS-eSL8Mynp4kQl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of recent transactions on a specified blockchain network that involve addresses in the user's watchlist","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"DeFi portfolio activity monitor","prompt":"Show me the most recent transactions involving my watched wallet addresses on Arbitrum — I want to see token transfers, fees paid, and whether each tx succeeded or failed."},{"title":"Security alert for tracked wallets","prompt":"Check Blockscout for any new transactions on my watchlist on Ethereum mainnet right now and flag any that look suspicious or involve large value transfers."},{"title":"Cross-chain watchlist comparison","prompt":"Fetch the latest watchlist transactions on Polygon (chain ID 137) via Blockscout so I can compare recent activity there against what I'm seeing on Optimism."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T00:58:50.695Z","isFirstParty":false}