Skip to main content

v1/{chainName}/address/{walletAddress}/transfers_v2/ REST API Endpoint - Gold Rush Wallet API

Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.

Updated on
May 12, 2025

Path Parameters

chainName
string
REQUIRED

The chain name eg: base-mainnet

walletAddress
string
REQUIRED

The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically

Query Parameters

quote-currency
string

The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP

contract-address
string

The requested contract address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically

starting-block
integer

The block height to start from, defaults to 0

ending-block
integer

The block height to end at, defaults to current block height

page-size
integer

The number of results to return per page. Omitting this parameter defaults to 100

page-number
integer

The page number to retrieve

Returns

data
object

The response data containing following fields:

address
string

The blockchain address for which transaction data is retrieved

updated_at
string

The timestamp when the data was last updated

quote_currency
string

The currency used for quoting values

chain_id
integer

The ID of the blockchain network

chain_name
string

The name of the blockchain network

items
array

An array of transaction items

block_signed_at
string

The timestamp when the block was signed

block_height
integer

The height of the block in the blockchain

block_hash
string

The unique hash of the block

tx_hash
string

The unique hash of the transaction

tx_offset
integer

The offset of the transaction in the block

successful
boolean

Indicates if the transaction was successful

miner_address
string

The address of the miner who validated the block

from_address
string

The sender's address for the transaction

from_address_label
string

A label for the sender's address, if available

to_address
string

The recipient's address for the transaction

to_address_label
string

A label for the recipient's address, if available

value
string

The value of the transaction

value_quote
integer

The quoted value of the transaction in the specified currency

pretty_value_quote
string

A formatted string of the quoted value

gas_metadata
object

Metadata about the gas used in the transaction

contract_decimals
integer

The number of decimals used by the token contract

contract_name
string

The name of the token contract

contract_ticker_symbol
string

The ticker symbol of the token contract

contract_address
string

The address of the token contract

supports_erc
array

A list of supported ERC standards

logo_url
string

The URL of the token's logo

gas_offered
integer

The amount of gas offered for the transaction

gas_spent
integer

The amount of gas spent for the transaction

gas_price
integer

The price of gas used in the transaction

fees_paid
string

The total fees paid for the transaction

gas_quote
integer

The quoted value of gas in the specified currency

pretty_gas_quote
string

A formatted string of the gas quote

gas_quote_rate
integer

The rate of gas in the specified currency

transfers
array

An array of transfer details within the transaction

block_signed_at
string

The timestamp when the block was signed

tx_hash
string

The unique hash of the transaction

from_address
string

The sender's address for the transfer

to_address
string

The recipient's address for the transfer

delta
string

The change in balance resulting from the transfer

pagination
object

Pagination details for the result set

has_more
boolean

Indicates if there are more pages of data

page_number
integer

The current page number

page_size
integer

The number of items per page

total_count
integer

The total number of items available

error
boolean

Indicates whether an error occurred

error_message
string

The error message if an error occurred, or null otherwise

error_code
string

The error code if an error occurred, or null otherwise

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free