getTransactionsByAddress

Learn how to use the getTransactionsByAddress JSON-RPC method.

POST /#particle_getTransactionsByAddress

getTransactionsByAddress

cURL

curl --request POST \
  --url 'https://rpc.particle.network/evm-chain/#particle_getTransactionsByAddress' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "particle_getTransactionsByAddress",
  "chainId": 1,
  "params": [
    "<string>"
  ]
}
'

import requests

url = "https://rpc.particle.network/evm-chain/#particle_getTransactionsByAddress"

payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "particle_getTransactionsByAddress",
    "chainId": 1,
    "params": ["<string>"]
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'particle_getTransactionsByAddress',
    chainId: 1,
    params: ['<string>']
  })
};

fetch('https://rpc.particle.network/evm-chain/#particle_getTransactionsByAddress', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://rpc.particle.network/evm-chain/#particle_getTransactionsByAddress",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'id' => 1,
    'method' => 'particle_getTransactionsByAddress',
    'chainId' => 1,
    'params' => [
        '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://rpc.particle.network/evm-chain/#particle_getTransactionsByAddress"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"particle_getTransactionsByAddress\",\n  \"chainId\": 1,\n  \"params\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://rpc.particle.network/evm-chain/#particle_getTransactionsByAddress")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"particle_getTransactionsByAddress\",\n  \"chainId\": 1,\n  \"params\": [\n    \"<string>\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://rpc.particle.network/evm-chain/#particle_getTransactionsByAddress")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"particle_getTransactionsByAddress\",\n  \"chainId\": 1,\n  \"params\": [\n    \"<string>\"\n  ]\n}"

response = http.request(request)
puts response.read_body

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "hash": "<string>",
      "from": "<string>",
      "to": "<string>",
      "value": "<string>",
      "data": "<string>",
      "gasLimit": 123,
      "timestamp": 123,
      "status": 123,
      "type": 123,
      "nonce": 123,
      "accessList": [
        {}
      ],
      "maxPriorityFeePerGas": "<string>",
      "maxFeePerGas": "<string>",
      "gasSpent": "<string>",
      "gasPrice": "<string>",
      "fees": "<string>"
    }
  ]
}

Contextualizing getTransactionsByAddress

• getTransactionsByAddress provides a detailed transaction history for a given address, including status and gas metrics. It returns all associated transactions, regardless of whether they’re pending, successful, or failed, along with the relevant transaction details like gas spent and fees for confirmed transactions.

---

Query example

JavaScript

const axios = require('axios');

(async () => {
    const response = await axios.post('https://rpc.particle.network/evm-chain', {
        chainId: 42,
        jsonrpc: '2.0',
        id: 1,
        method: 'particle_getTransactionsByAddress',
        params: ['0x425249Cf0F2f91f488E24cF7B1AA3186748f7516'],
    }, {
        auth: {
            username: 'Your Project Id',
            password: 'Your Project Server Key',
        }
    });

    console.log(response.data);
})();

Authorizations

Authorization · string · header · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

jsonrpc · string · default: 2 · required

Version of the JSON-RPC protocol, should be 2.0.

Example:

"2.0"

id · integer · default: 1 · required

The request identifier.

Example:

1

method · enum<string> · required

API method being called.

Available options: particle_getTransactionsByAddress

chainId · integer · required

The chain ID.

Example:

1

params · string[] · required

Parameters for the API method call.

Response

200 - application/json

Success

jsonrpc · string

Version of the JSON-RPC protocol, should be 2.0.

Example:

"2.0"

id · integer

The request identifier.

Example:

1

result · object[]

Array of transactions.

Show child attributes