Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Staking

Get staking transactions

/v4/data/staking/native/transactions

100 credits per API call

Get staking-related transactions for a Solana stake account or Ethereum withdrawal address. Returns deposits, topups, withdrawals, and credential changes.

Response shape differs by chain: Solana returns stakeAddress and transactions with stakeAddress/validatorAddress; Ethereum returns withdrawalAddress and transactions with withdrawalAddress/validatorIndex/validatorPubkey.

Supported blockchains:

  • Solana - solana-mainnet (create, stake, unstake, withdraw, split)
  • Ethereum - ethereum-mainnet (create=deposit, stake=topup, withdraw=withdrawal, credential_change=BLS→execution change)

Ethereum-specific: For beacon-only events (withdrawals, credential_change), txHash is a synthetic reference ID, not an on-chain execution transaction hash. blockNumber for credential_change is the consensus slot. amount is in ETH. Results are limited to 100,000 transactions per request; use type, timeFrom/timeTo, or epochFrom/epochTo filters for addresses with more history.

To get started:

  • Provide a chain and stake address (Solana stake account or Ethereum withdrawal address). The API will return all staking-related transactions.
  • You can filter transactions by type using the type parameter. Chain-specific: Solana supports create, stake, unstake, withdraw, split (not credential_change); Ethereum supports create, stake, withdraw, credential_change (not unstake, split). Using an unsupported type for a chain returns 400.
  • You can filter transactions by epoch range using epochFrom and epochTo parameters.
  • You can filter transactions by block range using blockFrom and blockTo parameters.
  • You can filter transactions by time range using timeFrom and timeTo parameters (ISO 8601 format).
  • You can filter transactions by unix timestamp range using unixFrom and unixTo parameters.
  • Important: You can only use one filter type at a time. Valid combinations: (epochFrom/epochTo), (blockFrom/blockTo), (timeFrom/timeTo), (unixFrom/unixTo). You cannot mix different types like epochFrom with blockTo.
  • Transactions are sorted by epoch in descending order (newest first).
get/v4/data/staking/native/transactions

Query parameters

chain'solana-mainnet' | 'ethereum-mainnet' required
Example:solana-mainnet

The blockchain to work with.

stakeAddressstring required
Example:8JMUtSoHS3h28tL7AJHP1SbXfhfeZSnpJ1hWZNCMSw9G

The blockchain address of the stake account (Solana) or withdrawal address (Ethereum).

type'create' | 'stake' | 'unstake' | 'withdraw' | 'split' | 'credential_change'
Example:stake

Filter transactions by type. credential_change (Ethereum only) = BLS→execution credential change.

epochFromnumber
Example:847

Filter transactions from this epoch (inclusive).

epochTonumber
Example:850

Filter transactions to this epoch (inclusive).

blockFromnumber
Example:365957848

Filter transactions from this block number (inclusive).

blockTonumber
Example:366007894

Filter transactions to this block number (inclusive).

timeFromstring date-time
Example:2024-01-01T00:00:00Z

Filter transactions from this date (inclusive). ISO 8601 format.

timeTostring date-time
Example:2024-12-31T23:59:59Z

Filter transactions to this date (inclusive). ISO 8601 format.

unixFromnumber
Example:1704067200

Filter transactions from this unix timestamp (inclusive).

unixTonumber
Example:1735689599

Filter transactions to this unix timestamp (inclusive).

Response

OK

OR

Example response

{
  "stakeAddress": "8JMUtSoHS3h28tL7AJHP1SbXfhfeZSnpJ1hWZNCMSw9G",
  "transactions": [
    {
      "txHash": "5JFC47k33cDR6cwAJXnusHiBmf2mSDwQ3WGUicv1vPXBzyWzXNg4r6SZS7sRk8o2q7m9vPJC8SygpKAfg9AoE2uQ",
      "blockNumber": 366007894,
      "timestamp": 1757552548,
      "epoch": 847,
      "type": "stake",
      "amount": "64598.00228288",
      "stakeAddress": "8JMUtSoHS3h28tL7AJHP1SbXfhfeZSnpJ1hWZNCMSw9G",
      "validatorAddress": "RuBYsjLeJYtWXbabcxPbNcbbFXQvMLrJGutpcqVRomz",
      "from": "HcTDaQXACrWUGZY6q1mWYFoxaQvqiBRR1D7JqFJgXrHM",
      "to": "EcH12jxhrbhF6qHqRzWpZ8rZU3TjG3sX6F67zP61oDJG",
      "by": "EcH12jxhrbhF6qHqRzWpZ8rZU3TjG3sX6F67zP61oDJG"
    }
  ]
}