GoldRush API Reference home page

GoldRush Platform
Support
GoldRush Platform

Bitcoin

Get transactions for Bitcoin address

API Reference

Overview
FAQs

Cross Chain

GET
Get activity across all chains for address
GET
Get multichain balances
GET
Get multichain & multiaddress transactions

Balances

GET
Get token balances for address
GET
Get historical token balances for address
GET
Get native token balance for address
GET
Get ERC20 token transfers for address
GET
Get historical portfolio value over time
GET
Get token holders as of any block height (v2)

Transactions

GET
Get a transaction
GET
Get transaction summary for address
GET
Get earliest transactions for address (v3)
GET
Get recent transactions for address (v3)
GET
Get paginated transactions for address (v3)
GET
Get bulk time bucket transactions for address (v3)
GET
Get all transactions in a block by page (v3)
GET
Get all transactions in a block (v3)

NFT

Core Rendering
Market Data
Ownership & Token Gating

Security

GET
Get token approvals for address
GET
Get NFT approvals for address

Bitcoin

GET
Get Bitcoin balances for HD address
GET
Get Bitcoin balances for non-HD address
GET
Get transactions for Bitcoin address

Utility

GET
Get logs
GET
Get log events by topic hash(es)
GET
Get log events by contract address
GET
Get a block
GET
Get block heights
GET
Get all chains
GET
Get all chain statuses
GET
Get resolved address for registered address
GET
Get gas prices
GET
Get historical token prices

Bitcoin

Get transactions for Bitcoin address

Used to fetch the full transaction history of a Bitcoin wallet.

GET

covalent

app

bitcoin

transactions

Authorization

string

Bearer

Authorization

Required

string

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

address

string

address

string

The bitcoin address to query.

page-size

integer

page-size

integer

Number of items per page. Omitting this parameter defaults to 100.

page-number

integer

page-number

integer

0-indexed page number to begin pagination.

^{Credit Cost: 0.1 per item.}
^{Processing: Realtime}

Only supports non-HD bitcoin addresses.

Query Parameters

address

string

The bitcoin address to query.

page-size

integer

Number of items per page. Omitting this parameter defaults to 100.

page-number

integer

0-indexed page number to begin pagination.

Response

200 - application/json

updated_at

string

The timestamp when the response was generated. Useful to show data staleness to users.

items

object[]

List of response items.

items.chain_id

integer

The requested chain ID eg: 20090103.

items.chain_name

string

The requested chain name eg: btc-mainnet.

items.contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

items.block_signed_at

string

The block signed timestamp in UTC.

items.block_height

integer

The height of the block.

items.block_hash

string

The hash of the block.

items.tx_hash

string

The requested transaction hash.

items.tx_idx

integer

The position index of the tx in the block.

items.type

string

Either 'input' as the sender or 'output' as the receiver of btc.

items.address

string

The wallet address.

items.value

string

b;The value attached to this tx in satoshi.

items.quote

number

The value attached to this tx in USD.

items.quote_rate

number

The value token exchange rate in USD.

items.fees_paid

string

b;The total transaction fees denoted in satoshi.

items.gas_quote

number

The gas spent in USD.

items.gas_quote_rate

number

The native gas token exchange rate in USD.

items.coinbase

boolean

Indicates if this is a coinbase tx where btc is rewarded to a miner for validating the block.

items.locktime

integer

The earliest Unix timestamp or block height at which the tx is valid and can be included. Is 0 if no restriction.

items.weight

integer

A measure that reflects impact on the block size limit. Used to determine fees.

pagination

object

Pagination metadata.

pagination.has_more

boolean

True if there is another page.

pagination.page_number

integer

The requested page number.

pagination.page_size

integer

The requested number of items on the current page.

pagination.total_count

integer

The total number of items across all pages for this request.

Get Bitcoin balances for non-HD address Get logs

x github linkedin