trace_filter

API key required. This Polygon Amoy method is documented for keyed private endpoints. It is not available on /v1/rpc/public. Create an endpoint to get an API key.

Network: Polygon Amoy · Testnet · Chain ID 80002 (0x13882)

Counts as 5 requests. See Request Counting.

trace_filter returns trace entries that match a block range and optional address filters. It is a paid trace method, not available on Free, and can be expensive for broad historical ranges.

Parameters

Object - Filter object:

Field	Type	Description
`fromBlock`	`QUANTITY\|TAG`	Start block.
`toBlock`	`QUANTITY\|TAG`	End block.
`fromAddress`	`Array<DATA>`	Optional sender addresses.
`toAddress`	`Array<DATA>`	Optional receiver addresses.
`after`	`QUANTITY`	Optional pagination offset.
`count`	`QUANTITY`	Optional page size.

Request


{
  "jsonrpc": "2.0",
  "method": "trace_filter",
  "params": [
    {
      "fromBlock": "0x1",
      "toBlock": "0x10",
      "count": "0x10"
    }
  ],
  "id": 1
}

Code Examples


curl -X POST https://polygon-amoy-bor-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"trace_filter","params":[{"fromBlock":"0x1","toBlock":"0x10","count":"0x10"}],"id":1}'


const response = await fetch("https://polygon-amoy-bor-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "method": "trace_filter",
  "params": [
    {
      "fromBlock": "0x1",
      "toBlock": "0x10",
      "count": "0x10"
    }
  ],
  "id": 1
}),
});
const data = await response.json();
console.log(data.result);


import requests

response = requests.post(
    "https://polygon-amoy-bor-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000",
    json={
  "jsonrpc": "2.0",
  "method": "trace_filter",
  "params": [
    {
      "fromBlock": "0x1",
      "toBlock": "0x10",
      "count": "0x10"
    }
  ],
  "id": 1
}
)
print(response.json()["result"])


package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{"jsonrpc":"2.0","method":"trace_filter","params":[{"fromBlock":"0x1","toBlock":"0x10","count":"0x10"}],"id":1}`)
	resp, err := http.Post(
		"https://polygon-amoy-bor-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000",
		"application/json",
		bytes.NewBuffer(payload),
	)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]interface{}
	json.Unmarshal(body, &result)
	fmt.Println(result["result"])
}


import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://polygon-amoy-bor-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000"),
});

const result = await client.request({
  method: "trace_filter",
  params: [{"fromBlock":"0x1","toBlock":"0x10","count":"0x10"}],
});
console.log(result);


cast rpc --rpc-url https://polygon-amoy-bor-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000 trace_filter {"fromBlock":"0x1","toBlock":"0x10","count":"0x10"}


const { ethers } = require("hardhat");

async function main() {
  const provider = new ethers.JsonRpcProvider("https://polygon-amoy-bor-rpc.blockreq.com/v1/rpc/BRQ1P0000000000000000000000000000000000000000000000000000000");
  const result = await provider.send("trace_filter", [{"fromBlock":"0x1","toBlock":"0x10","count":"0x10"}]);
  console.log(result);
}

main();

trace_filter

Parameters

Request

Code Examples

Try It