@nadohq/indexer-client

HTTP client for the Nado indexer. Provides typed queries for historical data including trade events, candlesticks, funding payments, snapshots, leaderboards, and paginated event streams.

Full SDK Documentation

Installation

npm install @nadohq/indexer-client @nadohq/engine-client @nadohq/shared viem bignumber.js

Most apps should use @nadohq/client instead, which includes this package. Install @nadohq/indexer-client directly for analytics services or read-heavy backends that only need indexer queries.

Usage

import { IndexerClient, INDEXER_CLIENT_ENDPOINTS } from '@nadohq/indexer-client';
import { createWalletClient, http } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { ink } from 'viem/chains';

const walletClient = createWalletClient({
  account: privateKeyToAccount('0x...'),
  chain: ink,
  transport: http(),
});

const indexer = new IndexerClient({
  url: INDEXER_CLIENT_ENDPOINTS.inkMainnet,
  walletClient,
});

// Get candlestick data
const candles = await indexer.getCandlesticks({ ... });

// List subaccount orders
const orders = await indexer.getOrders({ ... });

// Get paginated trade history
const trades = await indexer.getPaginatedSubaccountMatchEvents({ ... });

API Surface

Market Data

getCandlesticks, getMarketSnapshots, getQuotePrice, getV2Tickers, getV2Symbols, getFundingRate, getOraclePrice, getPerpPrices.

Subaccount History

listSubaccounts, getMultiSubaccountSnapshots, getOrders, getMatchEvents, getEvents, getInterestFundingPayments, getLinkedSignerWithRateLimit, getSubaccountDDA.

Paginated Queries

getPaginatedSubaccountMatchEvents, getPaginatedSubaccountOrders, getPaginatedSubaccountCollateralEvents, getPaginatedSubaccountSettlementEvents, getPaginatedSubaccountLiquidationEvents, getPaginatedSubaccountInterestFundingPayments, getPaginatedSubaccountNlpEvents, getPaginatedLeaderboard.

Leaderboards & Analytics

getLeaderboard, getLeaderboardParticipant, getMakerStatistics, getPoints, getReferralCode.

NLP

getNlpSnapshots, getNlpLockedBalances.

License

ISC