Skip to main content
GET
Get Bitcoin wallet transaction history
The walletAddressOrPublicKey path parameter accepts either a Bitcoin address or an xpub — when an xpub is supplied, history is aggregated across all derived addresses server-side.
Address auto-detection: for a Bitcoin address or xpub, the chains parameter is optional — Moralis detects the chain family from the address format. Passing chains=bitcoin explicitly still works.

Authorizations

X-Api-Key
string
header
required

Path Parameters

walletAddressOrPublicKey
string
required

A Bitcoin address or an xpub. When an xpub is supplied, the API derives all addresses server-side.

Query Parameters

chains
enum<string>[]

Chains to query. For the Bitcoin API, pass bitcoin.

Available options:
bitcoin
limit
number
default:100

The limit per page

Required range: 1 <= x <= 100
cursor
string

The cursor to the next page

order
enum<string>
default:DESC

The order of items

Available options:
ASC,
DESC
fromDate
string

The start date from which to get the wallet history (format in seconds or string accepted by momentjs)

  • Provide the param 'fromBlock' or 'fromDate'
  • If 'fromDate' and 'fromBlock' are provided, 'fromBlock' will be used.
toDate
string

The end date from which to get the wallet history (format in seconds or string accepted by momentjs)

  • Provide the param 'toBlock' or 'toDate'
  • If 'toDate' and 'toBlock' are provided, 'toBlock' will be used.
fromBlock
number

The minimum block number from which to get the wallet history

  • Provide the param 'fromBlock' or 'fromDate'
  • If 'fromDate' and 'fromBlock' are provided, 'fromBlock' will be used.
toBlock
number

The block number to get the wallet history until

verbose
boolean
default:false

When true, returns full raw chain-specific data including logs, input data, and vin/vout arrays. Array fields are capped at 100 items with a hasMore flag.

Response

200 - application/json
address
string
required

The queried wallet address

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

addressType
enum<string>
required

The wallet address type

Available options:
bitcoin
Example:

"evm"

cursor
string | null
required

Opaque cursor token for pagination (null when no more pages)

page
number
required

Current page number (1-indexed)

Example:

1

pageSize
number
required

Number of items in this page

result
object[]
required

Array of wallet history items

meta
object
required

Response metadata with sync status and diagnostics