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
        }
      }
    }
  ]
}
'

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

Authorizations

api-key

string

query

required

Your Helius API key. You can get one for free in the dashboard.

Body

application/json

jsonrpc

enum<string>

default:2.0

required

The JSON-RPC protocol version.

Available options:

2.0

Example:

"2.0"

string

default:1

required

A unique identifier for the request.

Example:

"1"

method

enum<string>

default:getTransactionsForAddress

required

The name of the RPC method to invoke.

Available options:

getTransactionsForAddress

Example:

"getTransactionsForAddress"

params

array

required

Array containing the required account address and optional configuration object.

Required array length: 1 - 2 elements

Example:

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

Response

Successfully retrieved transactions for the specified address.

jsonrpc

enum<string>

The JSON-RPC protocol version.

Available options:

2.0

Example:

"2.0"

string

Identifier matching the request.

Example:

"1"

result

object

Transaction data and pagination information.

Show child attributes

result.data

object[]

List of transaction information.

Signature-level transaction summary (when transactionDetails is "signatures").

Option 1
Option 2

Show child attributes

result.data.signature

string

required

Transaction signature as a base-58 encoded string.

Example:

"5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv"

result.data.slot

integer

required

The slot that contains the block with the transaction.

Example:

1054

result.data.err

object

Error if the transaction failed, or null if successful.

Example:

null

result.data.memo

string | null

Memo associated with the transaction, or null if none.

Example:

null

result.data.blockTime

integer | null

Estimated production time as Unix timestamp (seconds since epoch), or null if not available.

Example:

1641038400

result.data.confirmationStatus

enum<string> | null

Transaction's cluster confirmation status.

Available options:

processed,

confirmed,

finalized

Example:

"finalized"

result.paginationToken

string | null

Pagination token for next page, or null if no more results.

Example:

"1055:5"

getSignatureStatusesReturns the statuses of a list of signatures. Each signature must be a txid, the first signature of a transaction.

⌘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
        }
      }
    }
  ]
}
'

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

API Reference

Solana RPC APIs

Solana APIs

Data Streaming APIs

Event Listening APIs

Deprecated APIs

getTransactionsForAddress

Authorizations

Body

Response