{"uid":"cap_J2ZB91l1t69vrl6h_XOtC","slug":"blockscout-watchlist-transactions-6476213f","name":"Blockscout Watchlist Transactions","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/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"}}},"queryParams":{"type":"object","properties":{"index":{"type":"integer"},"items_count":{"type":"integer"},"block_number":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"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}],"next_page_params":{}}},"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_zAe9MEGyzy7mozAxDay3k","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":"Retrieves paginated transactions from a user's watchlist on a specified blockchain network via Blockscout","exampleAgentPrompt":"Show me the latest 25 watchlist transactions on the Ethereum mainnet chain (chain_id: eth) using Blockscout, starting from block 19000000.","exampleUseCases":[{"title":"DeFi wallet activity monitoring","prompt":"Pull the last 50 watchlist transactions on Arbitrum from Blockscout so I can see what my monitored DeFi addresses have been doing lately."},{"title":"Cross-chain portfolio surveillance","prompt":"Get me the most recent watchlist transactions on Polygon from Blockscout — I want to check if any of my saved addresses moved tokens in the last few blocks."},{"title":"Paginated transaction audit","prompt":"Fetch the next page of watchlist transactions on Ethereum from Blockscout, starting at index 20 with 10 items per page, so I can audit my watched addresses' activity around block 18500000."}],"resultDescription":"Returns a paginated list of transaction objects for watched addresses on the specified chain. Each item includes transaction hash, from/to addresses with metadata (ENS names, tags, contract status, scam flags), fee breakdown, gas details, token transfers, decoded input data, timestamps, block number, confirmations, and chain-specific data (e.g. Arbitrum batch and commitment info). Also returns a 'next_page_params' object for cursor-based pagination.","failureModes":["Invalid or unsupported chain_id returns 404 or empty result","Missing authentication or watchlist not configured returns empty items array","Invalid pagination parameters (negative index or items_count) may return 400 error","Rate limiting may occur for high-frequency polling","Truncated response schema may omit some fields for complex transactions"],"whenToPreferThis":"Use this endpoint when you need to monitor or audit transactions specifically for a curated set of addresses saved in a Blockscout watchlist, across a specific blockchain network. Prefer this over general transaction search when the user wants ongoing surveillance of known addresses rather than a one-off lookup. Best for portfolio trackers, compliance tools, or alert systems watching specific wallets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T18:55:37.802Z","isFirstParty":false}