trace_filter

trace_filter scans a contiguous range of Polygon blocks and returns every trace (internal call, create, or suicide frame) whose sender and/or recipient match the supplied filter. Unlike trace_block — which is keyed to a single block — or trace_transaction — which is keyed to one transaction hash — trace_filter lets you sweep a window of history and narrow it down by address. It is the right tool for building an account's incoming/outgoing internal-transfer history, or for indexing all activity that touched a particular contract.

This is the Parity-style tracer. Note that Polygon's Bor client can emit a slightly different frame shape than vanilla Geth-Parity (for example call vs delegatecall mapping), so an indexer should be tolerant of both. If you also consume the Geth-style debug_traceBlockByNumber, its output schema differs and your decoder must handle each shape separately.

Because a single block range can produce a very large number of traces, results are paginated with the after (offset) and count (limit) fields and the payload grows roughly linearly with the block range. Keep ranges modest and page through large result sets rather than requesting a huge window in one call.

This method requires the Pro tier. Calls authenticated with a lower-tier key are rejected with -32002 tier_insufficient.

A single positional parameter: a filter object.

Response fields

result is an array of trace objects. Each object contains:

These follow the standard Triport JSON-RPC error envelope — see the shared errors reference for the full response shape, HTTP status mapping, and retry guidance.

JavaScript (fetch)

const res = await fetch("https://api.triport.io/v1/polygon", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "trace_filter",
    params: [{
      fromBlock: "0x2faf080",
      toBlock: "0x2faf090",
      toAddress: ["0x4f76e3b3cd2cf3a23e0c11a9f6f5f29c5e3f1f0a"],
      after: 0,
      count: 100,
    }],
  }),
});
const { result } = await res.json();
console.log(`${result.length} traces`);

TypeScript SDK (@triport/sdk)

import { Triport } from "@triport/sdk";


const client = new Triport({ apiKey: process.env.TRIPORT_API_KEY! });


const traces = await client.polygon.traceFilter({
  fromBlock: "0x2faf080",
  toBlock: "0x2faf090",
  toAddress: ["0x4f76e3b3cd2cf3a23e0c11a9f6f5f29c5e3f1f0a"],
  after: 0,
  count: 100,
});


for (const t of traces) {
  console.log(t.transactionHash, t.action.value);
}

Python (triport-sdk)

import os
from triport import Triport


client = Triport(api_key=os.environ["TRIPORT_API_KEY"])


traces = client.polygon.trace_filter({
    "fromBlock": "0x2faf080",
    "toBlock": "0x2faf090",
    "toAddress": ["0x4f76e3b3cd2cf3a23e0c11a9f6f5f29c5e3f1f0a"],
    "after": 0,
    "count": 100,
})


for t in traces:
    print(t["transactionHash"], t["action"]["value"])

• Numeric blocks, not tags. This is the most common cause of a -32602 on Polygon trace_filter. Always resolve "latest" to a concrete block number (e.g. via eth_blockNumber) and pass the hex value.
• Chunk wide ranges. The response payload grows roughly linearly with the block range; a full-history filter in a single call can run to many megabytes. Iterate in fixed-size block windows (e.g. 100–1000 blocks) and paginate within each window rather than requesting one enormous range.
• Pagination. To page through a large result set, keep count fixed and advance after by count on each call (after: 0, then after: 100, …) until a page returns fewer than count traces. The result order is stable for a fixed block range.
• Address filters are OR-within / AND-across. Multiple entries in fromAddress match any of them; supplying both fromAddress and toAddress requires a trace to satisfy both sides.
• Related methods: trace_block for a single block, trace_transaction for one transaction, trace_call to trace a hypothetical call, and trace_replayBlockTransactions for a full block replay with state diff. All trace_* methods require the Pro tier.