getTransactionsForAddress Método RPC Solana

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"
  }
}

Parâmetros da Solicitação

string

obrigatório

Endereço da conta Solana para recuperar o histórico de transações (carteira, token, programa, NFT, etc.).

string

padrão:"signatures"

Nível de detalhe da transação a ser retornado.

signatures
full

string

padrão:"desc"

Ordem de classificação para as transações retornadas.

asc
desc

string

padrão:"finalized"

O nível de compromisso para a solicitação. O processed compromisso não é suportado.

confirmed
finalized

number

Slot de contexto mínimo a ser usado para a solicitação (opcional).

number

padrão:"1000"

Número máximo de transações por solicitação. Use 1–1000 para transactionDetails:“signatures” e 1–1000 para transactionDetails:“full”.

string

Token de paginação da resposta anterior para obter a próxima página de resultados (formato “slot:position”).

string

padrão:"json"

Formato de codificação para dados de transação (aplica-se somente quando transactionDetails=full).

json
jsonParsed
base58
base64

number

Versão máxima de transação a ser retornada (aplica-se somente quando transactionDetails=full).

object

Filtros avançados para restringir os resultados das transações.

object

Filtrar por número de slot.

number

Maior ou igual ao número de slot.

number

Maior que o número de slot.

number

Menor ou igual ao número de slot.

number

Menor que o número de slot.

object

Filtrar por timestamp do bloco (timestamp Unix).

number

Maior ou igual ao timestamp.

number

Maior que o timestamp.

number

Menor ou igual ao timestamp.

number

Menor que o timestamp.

number

Igual ao timestamp.

object

Filtrar por assinatura de transação.

string

Obter transações com assinaturas maiores ou iguais a este valor.

string

Obter transações após esta assinatura.

string

Obter transações com assinaturas menores ou iguais a este valor.

string

Obter transações antes desta assinatura.

string

padrão:"any"

Filtrar por status da transação.

succeeded
failed
any

string

padrão:"none"

Filtrar transações para contas de token relacionadas. Controla se deve incluir transações envolvendo contas de token de propriedade do endereço.

none
balanceChanged
all

object

Restringe os resultados às transações onde o endereço consultado participou de uma transferência de token que corresponde a critérios específicos. Todos os campos são opcionais e combinados com a semântica AND.

string

Endereço da contraparte. Corresponde a transferências cujo outro lado é este endereço.

string

padrão:"any"

Direção da transferência em relação ao endereço consultado.

in
out
any

string

Mint do token para filtrar.

object

Filtro de intervalo de quantidade bruta na cadeia. Todos os campos são opcionais e podem ser combinados.

Autorizações

api-key

string

query

obrigatório

Sua chave de API Helius. Você pode obter uma gratuitamente no dashboard.

Corpo

application/json

jsonrpc

enum<string>

padrão:2.0

obrigatório

A versão do protocolo JSON-RPC.

Opções disponíveis:

2.0

Exemplo:

"2.0"

string

padrão:1

obrigatório

Um identificador único para a solicitação.

Exemplo:

"1"

method

enum<string>

padrão:getTransactionsForAddress

obrigatório

O nome do método RPC a ser invocado.

Opções disponíveis:

getTransactionsForAddress

Exemplo:

"getTransactionsForAddress"

params

tuple

obrigatório

Array contendo o endereço da conta necessária e um objeto de configuração opcional.

Show child attributes

Exemplo:

[
  "Vote111111111111111111111111111111111111111",
  {
    "transactionDetails": "signatures",
    "limit": 50,
    "sortOrder": "desc",
    "filters": {
      "status": "succeeded",
      "slot": { "gte": 1000, "lt": 2000 },
      "tokenTransfer": {
        "direction": "in",
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
      }
    }
  }
]

Resposta

Transações recuperadas com sucesso para o endereço especificado.

jsonrpc

enum<string>

A versão do protocolo JSON-RPC.

Opções disponíveis:

2.0

Exemplo:

"2.0"

string

Identificador correspondente à solicitação.

Exemplo:

"1"

result

object

Dados da transação e informações de paginação.

Show child attributes

URLs e Endpoints de Solana RPC

getTransfersByAddress

⌘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"
  }
}

Referência de API

Solana RPC APIs

Solana APIs

APIs de Transmissão de Dados

APIs de Escuta de Eventos

APIs de Gerenciamento de Contas

getTransactionsForAddress

Parâmetros da Solicitação

Autorizações

Corpo

Resposta

​Parâmetros da Solicitação

Autorizações

Corpo

Resposta

Parâmetros da Solicitação