getTransactionsForAddress Solana RPC Method

POST

getTransactionsForAddress

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getTransactionsForAddress",
  "params": [
    "Vote111111111111111111111111111111111111111",
    {
      "transactionDetails": "signatures",
      "limit": 50,
      "sortOrder": "desc",
      "filters": {
        "status": "succeeded",
        "slot": {
          "gte": 1000,
          "lt": 2000
        },
        "tokenTransfer": {
          "direction": "in",
          "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
        }
      }
    }
  ]
}
'

import requests

url = "https://mainnet.helius-rpc.com/?api-key="

payload = {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getTransactionsForAddress",
    "params": [
        "Vote111111111111111111111111111111111111111",
        {
            "transactionDetails": "signatures",
            "limit": 50,
            "sortOrder": "desc",
            "filters": {
                "status": "succeeded",
                "slot": {
                    "gte": 1000,
                    "lt": 2000
                },
                "tokenTransfer": {
                    "direction": "in",
                    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
                }
            }
        }
    ]
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTransactionsForAddress',
    params: [
      'Vote111111111111111111111111111111111111111',
      {
        transactionDetails: 'signatures',
        limit: 50,
        sortOrder: 'desc',
        filters: {
          status: 'succeeded',
          slot: {gte: 1000, lt: 2000},
          tokenTransfer: {direction: 'in', mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'}
        }
      }
    ]
  })
};

fetch('https://mainnet.helius-rpc.com/?api-key=', 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://mainnet.helius-rpc.com/?api-key=",
  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' => 'getTransactionsForAddress',
    'params' => [
        'Vote111111111111111111111111111111111111111',
        [
                'transactionDetails' => 'signatures',
                'limit' => 50,
                'sortOrder' => 'desc',
                'filters' => [
                                'status' => 'succeeded',
                                'slot' => [
                                                                'gte' => 1000,
                                                                'lt' => 2000
                                ],
                                'tokenTransfer' => [
                                                                'direction' => 'in',
                                                                'mint' => 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "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://mainnet.helius-rpc.com/?api-key="

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getTransactionsForAddress\",\n  \"params\": [\n    \"Vote111111111111111111111111111111111111111\",\n    {\n      \"transactionDetails\": \"signatures\",\n      \"limit\": 50,\n      \"sortOrder\": \"desc\",\n      \"filters\": {\n        \"status\": \"succeeded\",\n        \"slot\": {\n          \"gte\": 1000,\n          \"lt\": 2000\n        },\n        \"tokenTransfer\": {\n          \"direction\": \"in\",\n          \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"\n        }\n      }\n    }\n  ]\n}")

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

	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://mainnet.helius-rpc.com/?api-key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getTransactionsForAddress\",\n  \"params\": [\n    \"Vote111111111111111111111111111111111111111\",\n    {\n      \"transactionDetails\": \"signatures\",\n      \"limit\": 50,\n      \"sortOrder\": \"desc\",\n      \"filters\": {\n        \"status\": \"succeeded\",\n        \"slot\": {\n          \"gte\": 1000,\n          \"lt\": 2000\n        },\n        \"tokenTransfer\": {\n          \"direction\": \"in\",\n          \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"\n        }\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mainnet.helius-rpc.com/?api-key=")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getTransactionsForAddress\",\n  \"params\": [\n    \"Vote111111111111111111111111111111111111111\",\n    {\n      \"transactionDetails\": \"signatures\",\n      \"limit\": 50,\n      \"sortOrder\": \"desc\",\n      \"filters\": {\n        \"status\": \"succeeded\",\n        \"slot\": {\n          \"gte\": 1000,\n          \"lt\": 2000\n        },\n        \"tokenTransfer\": {\n          \"direction\": \"in\",\n          \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"\n        }\n      }\n    }\n  ]\n}"

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

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "data": [
      {
        "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
        "slot": 1054,
        "transactionIndex": 42,
        "err": null,
        "memo": null,
        "blockTime": 1641038400,
        "confirmationStatus": "finalized"
      },
      {
        "signature": "kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
        "slot": 1055,
        "transactionIndex": 15,
        "err": null,
        "memo": null,
        "blockTime": 1641038460,
        "confirmationStatus": "finalized"
      }
    ],
    "paginationToken": "1055:5"
  }
}

Paramètres de requête

string

requis

Adresse du compte Solana pour récupérer l’historique des transactions (portefeuille, jeton, programme, NFT, etc.).

string

défaut:"signatures"

Niveau de détail des transactions à retourner.

signatures
full

string

défaut:"desc"

Ordre de tri pour les transactions retournées.

asc
desc

string

défaut:"finalized"

Le niveau d’engagement pour la requête. L’engagement processed n’est pas pris en charge.

confirmed
finalized

number

Slot de contexte minimum à utiliser pour la requête (optionnel).

number

défaut:"1000"

Nombre maximum de transactions par requête. Utilisez 1–1000 pour transactionDetails:“signatures” et 1–1000 pour transactionDetails:“full”.

string

Jeton de pagination de la réponse précédente pour obtenir la page suivante des résultats (format “slot:position”).

string

défaut:"json"

Format d’encodage pour les données de transaction (s’applique uniquement lorsque transactionDetails=full).

json
jsonParsed
base58
base64

number

Version maximale de transaction à retourner (s’applique uniquement lorsque transactionDetails=full). Réglez sur 1 pour recevoir des transactions legacy, v0 et v1.

object

Filtres avancés pour affiner les résultats des transactions.

object

Filtrer par numéro de slot.

number

Supérieur ou égal au numéro de slot.

number

Supérieur au numéro de slot.

number

Inférieur ou égal au numéro de slot.

number

Inférieur au numéro de slot.

object

Filtrer par horodatage du bloc (timestamp Unix).

number

Supérieur ou égal à l’horodatage.

number

Supérieur à l’horodatage.

number

Inférieur ou égal à l’horodatage.

number

Inférieur à l’horodatage.

number

Égal à l’horodatage.

object

Filtrer par signature de transaction.

string

Obtenez les transactions dont les signatures sont supérieures ou égales à cette valeur.

string

Obtenez les transactions après cette signature.

string

Obtenez les transactions dont les signatures sont inférieures ou égales à cette valeur.

string

Obtenez les transactions avant cette signature.

string

défaut:"any"

Filtrer par statut de transaction.

succeeded
failed
any

string

défaut:"none"

Filtrer les transactions pour les comptes de jetons associés. Contrôle si les transactions impliquant des comptes de jetons détenus par l’adresse sont incluses.

none
balanceChanged
all

object

Réduit les résultats aux transactions où l’adresse interrogée a participé à un transfert de jetons correspondant à des critères spécifiques. Tous les champs sont optionnels et combinés avec une sémantique AND.

string

Adresse de la contrepartie. Correspond aux transferts dont l’autre côté est cette adresse.

string

défaut:"any"

Direction du transfert par rapport à l’adresse interrogée.

in
out
any

string

Monnaie de jeton à filtrer.

object

Filtre de plage de quantité brute sur la chaîne. Tous les champs sont optionnels et peuvent être combinés.

Autorisations

api-key

string

query

requis

Votre clé API Helius. Vous pouvez en obtenir une gratuitement sur le tableau de bord.

Corps

application/json

jsonrpc

enum<string>

défaut:2.0

requis

La version du protocole JSON-RPC.

Options disponibles:

2.0

Exemple:

"2.0"

string

défaut:1

requis

Un identifiant unique pour la requête.

Exemple:

"1"

method

enum<string>

défaut:getTransactionsForAddress

requis

Le nom de la méthode RPC à invoquer.

Options disponibles:

getTransactionsForAddress

Exemple:

"getTransactionsForAddress"

params

(string | object)[]

requis

Tableau contenant l'adresse de compte requise et l'objet de configuration facultatif.

Required array length: 1 - 2 elements

Adresse du compte Solana pour récupérer l'historique des transactions (portefeuille, jeton, programme, NFT, etc.).

Exemple:

"Vote111111111111111111111111111111111111111"

Réponse

Transactions récupérées avec succès pour l'adresse spécifiée.

jsonrpc

enum<string>

La version du protocole JSON-RPC.

Options disponibles:

2.0

Exemple:

"2.0"

string

Identifiant correspondant à la requête.

Exemple:

"1"

result

object

Données de transaction et informations de pagination.

Show child attributes

⌘I

getTransactionsForAddress

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getTransactionsForAddress",
  "params": [
    "Vote111111111111111111111111111111111111111",
    {
      "transactionDetails": "signatures",
      "limit": 50,
      "sortOrder": "desc",
      "filters": {
        "status": "succeeded",
        "slot": {
          "gte": 1000,
          "lt": 2000
        },
        "tokenTransfer": {
          "direction": "in",
          "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
        }
      }
    }
  ]
}
'

import requests

url = "https://mainnet.helius-rpc.com/?api-key="

payload = {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getTransactionsForAddress",
    "params": [
        "Vote111111111111111111111111111111111111111",
        {
            "transactionDetails": "signatures",
            "limit": 50,
            "sortOrder": "desc",
            "filters": {
                "status": "succeeded",
                "slot": {
                    "gte": 1000,
                    "lt": 2000
                },
                "tokenTransfer": {
                    "direction": "in",
                    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
                }
            }
        }
    ]
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTransactionsForAddress',
    params: [
      'Vote111111111111111111111111111111111111111',
      {
        transactionDetails: 'signatures',
        limit: 50,
        sortOrder: 'desc',
        filters: {
          status: 'succeeded',
          slot: {gte: 1000, lt: 2000},
          tokenTransfer: {direction: 'in', mint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'}
        }
      }
    ]
  })
};

fetch('https://mainnet.helius-rpc.com/?api-key=', 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://mainnet.helius-rpc.com/?api-key=",
  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' => 'getTransactionsForAddress',
    'params' => [
        'Vote111111111111111111111111111111111111111',
        [
                'transactionDetails' => 'signatures',
                'limit' => 50,
                'sortOrder' => 'desc',
                'filters' => [
                                'status' => 'succeeded',
                                'slot' => [
                                                                'gte' => 1000,
                                                                'lt' => 2000
                                ],
                                'tokenTransfer' => [
                                                                'direction' => 'in',
                                                                'mint' => 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "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://mainnet.helius-rpc.com/?api-key="

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getTransactionsForAddress\",\n  \"params\": [\n    \"Vote111111111111111111111111111111111111111\",\n    {\n      \"transactionDetails\": \"signatures\",\n      \"limit\": 50,\n      \"sortOrder\": \"desc\",\n      \"filters\": {\n        \"status\": \"succeeded\",\n        \"slot\": {\n          \"gte\": 1000,\n          \"lt\": 2000\n        },\n        \"tokenTransfer\": {\n          \"direction\": \"in\",\n          \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"\n        }\n      }\n    }\n  ]\n}")

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

	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://mainnet.helius-rpc.com/?api-key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getTransactionsForAddress\",\n  \"params\": [\n    \"Vote111111111111111111111111111111111111111\",\n    {\n      \"transactionDetails\": \"signatures\",\n      \"limit\": 50,\n      \"sortOrder\": \"desc\",\n      \"filters\": {\n        \"status\": \"succeeded\",\n        \"slot\": {\n          \"gte\": 1000,\n          \"lt\": 2000\n        },\n        \"tokenTransfer\": {\n          \"direction\": \"in\",\n          \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"\n        }\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mainnet.helius-rpc.com/?api-key=")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getTransactionsForAddress\",\n  \"params\": [\n    \"Vote111111111111111111111111111111111111111\",\n    {\n      \"transactionDetails\": \"signatures\",\n      \"limit\": 50,\n      \"sortOrder\": \"desc\",\n      \"filters\": {\n        \"status\": \"succeeded\",\n        \"slot\": {\n          \"gte\": 1000,\n          \"lt\": 2000\n        },\n        \"tokenTransfer\": {\n          \"direction\": \"in\",\n          \"mint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\"\n        }\n      }\n    }\n  ]\n}"

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

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "data": [
      {
        "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
        "slot": 1054,
        "transactionIndex": 42,
        "err": null,
        "memo": null,
        "blockTime": 1641038400,
        "confirmationStatus": "finalized"
      },
      {
        "signature": "kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
        "slot": 1055,
        "transactionIndex": 15,
        "err": null,
        "memo": null,
        "blockTime": 1641038460,
        "confirmationStatus": "finalized"
      }
    ],
    "paginationToken": "1055:5"
  }
}

Commencer

Diffusion de données et écoute d'événements

API de données et RPC

Trading

Envoyer des transactions

Gestion de compte

getTransactionsForAddress

Paramètres de requête

Autorisations

Corps

Réponse

​Paramètres de requête

Autorisations

Corps

Réponse

Paramètres de requête