This is a collection of utilities to query Horizon data from BSC. This data has been indexed by The Graph via the various subgraphs the Horizon team maintains (the subgraph code repo).
The below all return a Promise that resolves with the requested results.
depot.userActions({ user })
Get all depot deposit (zUSD
) actions for the given user -deposit
,withdrawl
,unaccepted
,removed
.depot.clearedDeposits({ fromAddress, toAddress })
Get all cleared zasset deposits (payments ofETH
forzUSD
) either from a givenfromAddress
or (and as well as) to a giventoAddress
depot.exchanges({ from })
Get all depot exchanges (buying zUSD with ETH) for a givenfrom
address.exchanges.total()
Get the total exchange volume, total fees and total number of unique exchange addresses.exchanges.rebates({ minTimestamp = 1 day ago })
Get the lastN
exchange rebates since the givenminTimestamp
in seconds. Ordered in reverse chronological order.exchanges.reclaims({ minTimestamp = 1 day ago })
Get the lastN
exchange reclaims since the givenminTimestamp
in seconds. Ordered in reverse chronological order.exchanges.since({ minTimestamp = 1 day ago })
Get the lastN
exchanges since the givenminTimestamp
(in seconds, so one hour ago is3600
). These are ordered in reverse chronological order.rate.updates
Get all rate updates for zassets in reverse chronological orderzassets.issuers
Get all wallets that have invokedIssue
onzUSD
(other zassets to come)zassets.transfers
Get zasset transfers in reverse chronological orderzassets.holders
Get all potential zasset holdershzn.holders
Get the list of wallets that have ever sent or receivedHZN
.hzn.rewards
Get the list of reward escrow holders and their latest balance at vesting entry add or vest.hzn.total
Get the total count of uniqueissuers
andhznHolders
hzn.transfers
Get HZN transfers in reverse chronological orderhzn.issued
Get theIssued
events in reverse chronological order.hzn.burned
Get theBurned
events in reverse chronological order.hzn.feesClaimed
Get theFeesClaimed
events in reverse chronological order, showing fees in zUSD and rewards in hzn.hzn.debtSnapshot
Get the historical debt balance for any wallet address.binaryOptions.markets
Get all the binary options markets created.binaryOptions.optionTransactions
Get all the Bid and Refund transactions made to the binary options markets.binaryOptions.historicalOptionPrice
Get historical records of every option price for every market.etherCollateral.loans
Get the list of all EtherCollateral loans opened.exchanger.exchangeEntriesSettled({ max, from })
Get the list of all settled exchanges.exchanges.aggregate({ max, timeSeries })
Get the total amount of exchanges aggregated across various time series.rate.hznAggregate({ max, timeSeries })
Get the price of hzn aggregated across various time series.hzn.aggregateActiveStakers({ max, timeSeries })
Get the number of active stakers across various time series.hzn.totalActiveStakers()
Get the current number of active stakers.rate.dailyRateChange({ zassets })
get the rate change over the past 24 hours for any zasset. Can pass in a list to retrieve multiple zassets.liquidations.accountsRemovedFromLiquidation({ maxTime, minTime, account, max })
finds all the accounts that have fixed their c-ratio to avoid being at risk of liquidation after being flagged.liquidations.accountsFlaggedForLiquidation({ minTime, maxTime, account, max })
finds all the accounts that have been flagged for liquidation.liquidations.accountsLiquidated({ maxTime, minTime, account, max })
finds all the accounts that have been liquidated after being flagged for liquidation.liquidations.getActiveLiquidations({ max, account, minTime, maxTime })
finds all the accounts that have been flagged and are still pending liquidation or in a waiting state. Can also just check for a specific account if desired.
The below all return an Observable that when subscribed to with an object.
exchanges.observe()
Get an observable tosubscribe
to that willnext
the latest exchanges in real time (replays the most recent exchange immediately).rate.observe()
Get an observable tosubscribe
to that willnext
the latest rates in real time (replays the most recent exchange immediately).
const hznData = require('horizon-data'); // common js
// or
import hznData from 'horizon-data'; // es modules
// query and log resolved results
hznData.exchanges
.since({
minTimestamp: Math.floor(Date.now() / 1e3) - 3600 * 24, // one day ago
})
.then(exchanges => console.log(exchanges));
// subscribe and log streaming results
hznData.exchanges.observe().subscribe({
next(val) {
console.log(val);
},
error: console.error,
complete() {
console.log('done');
},
});
<script src="//cdn.jsdelivr.net/npm/horizon-data/browser.js"></script>
<script>
window.hznData.exchanges
.since({
minTimestamp: Math.floor(Date.now() / 1e3) - 3600 * 24, // one day ago
})
.then(console.log);
window.hznData.exchanges.observe().subscribe({ next: console.log });
</script>
# get last 24 hours of exchange activity, ordered from latest to earliest
npx horizon-data exchanges.since
# get exchanges on horizon as they occur in real time (replays the last exchange first)
npx horizon-data exchanges.subscribe