Balance history
Returns a balance history for the specified XPUB or address.
This method will use 10
Compute Units.
Reference: Here
GET /api/v2/balancehistory/<XPUB | address>?from=<dateFrom>&to=<dateTo>[&fiatcurrency=<currency>&groupBy=<groupBySeconds>]
Parameters
Required parameters
XPUB or address
- string, required.
Example: bc1q262qeyyhdakrje5qaux8m2a3r4z8sw8vu5mysh
(address)
dateFrom
- Unix timestamp, required.
Example: 1704067200
dateTo
- Unix timestamp, required.
Example: 1715160143
Optional parameters
fiatcurrency
: if specified, the response will contain secondary (fiat) rate at the time of transaction. If not, all available currencies will be returned.groupBy
: an interval in seconds, to group results by. Default is 3600 seconds.
Returns
Example response (fiatcurrency=usd):
[
{
"time": 1708239600,
"txs": 9,
"received": "2970",
"sent": "0",
"sentToSelf": "0",
"rates": {
"usd": 51518.35
}
},
....
{
"time": 1715144400,
"txs": 1,
"received": "2310",
"sent": "0",
"sentToSelf": "0",
"rates": {
"usd": 62560.055
}
}
]
curl https://mainnet.bitcoin.validationcloud.io/v1/<YOUR_API_KEY>/api/v2/balancehistory/bc1q262qeyyhdakrje5qaux8m2a3r4z8sw8vu5mysh?from=1704067200&to=1715160143&fiatcurrency=usd \
-X GET \
-H "Content-Type: application/json"
Last updated
Was this helpful?