@nadohq/indexer-client 0.41.0 → 0.42.0

package/dist/types/serverTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"serverTypes.js","names":[],"sources":["../../src/types/serverTypes.ts"],"sourcesContent":["import {\n  EIP712LeaderboardAuthenticationValues,\n  EIP712SocialAuthenticationValues,\n  SignedTx,\n} from '@nadohq/shared';\nimport { IndexerEventType } from './IndexerEventType';\nimport { IndexerLeaderboardRankType } from './IndexerLeaderboardType';\nimport { NadoWithdrawCollateralTx, NadoWithdrawCollateralV2Tx } from './NadoTx';\nimport {\n  IndexerServerCandlestick,\n  IndexerServerEvent,\n  IndexerServerLeaderboardContest,\n  IndexerServerLeaderboardPosition,\n  IndexerServerLeaderboardRegistration,\n  IndexerServerMaker,\n  IndexerServerMarketSnapshot,\n  IndexerServerMarketSnapshotInterval,\n  IndexerServerMatchEvent,\n  IndexerServerNlpSnapshot,\n  IndexerServerOraclePrice,\n  IndexerServerOrder,\n  IndexerServerProductPayment,\n  IndexerServerProductSnapshot,\n  IndexerServerSnapshotsInterval,\n  IndexerServerSocialAccount,\n  IndexerServerTx,\n} from './serverModelTypes';\n\n/**\n * Params\n */\n\nexport interface IndexerServerListSubaccountsParams {\n  // Inclusive, defaults to 0\n  start?: number;\n  // Defaults to 100\n  limit?: number;\n  address?: string;\n}\n\nexport interface IndexerServerMultiSubaccountSnapshotsParams {\n  // Subaccount hex identifiers\n  subaccounts: string[];\n  timestamps: number[];\n  // If not given, will return both isolated & non-iso balances\n  isolated?: boolean;\n}\n\nexport interface IndexerServerReferralCodeParams {\n  subaccount: string;\n}\n\nexport interface IndexerServerFundingRateParams {\n  product_id: number;\n}\n\nexport interface IndexerServerFundingRatesParams {\n  product_ids: number[];\n}\n\nexport interface IndexerServerFundingRateHistoryParams {\n  product_id: number;\n  start_time?: number | string;\n  end_time?: number | string;\n  // Max number of rates to return. Defaults to 100, max 1000.\n  limit?: number;\n}\n\nexport interface IndexerServerPriceParams {\n  product_id: number;\n}\n\nexport interface IndexerServerPerpPricesParams {\n  product_ids: number[];\n}\n\nexport interface IndexerServerPortfolioParams {\n  subaccount: string;\n}\n\nexport interface IndexerServerOraclePricesParams {\n  product_ids: number[];\n}\n\nexport interface IndexerServerCandlesticksParams {\n  product_id: number;\n  granularity: number;\n  // Seconds\n  max_time?: number;\n  limit: number;\n}\n\nexport type IndexerEdgeServerCandlesticksParams =\n  IndexerServerCandlesticksParams;\n\nexport interface IndexerServerProductsParams {\n  product_id: number;\n  max_time?: number;\n  limit: number;\n  // submission_idx for pagination, inclusive\n  idx?: string;\n}\n\nexport interface IndexerServerMultiProductsParams {\n  product_ids: number[];\n  max_time: number[];\n}\n\nexport interface IndexerServerEventsParams {\n  subaccounts?: string[];\n  product_ids?: number[];\n  // If not given, will return both isolated & non-iso events\n  isolated?: boolean;\n  event_types?: IndexerEventType[];\n  // Descending order for idx (time), defaults to true\n  desc?: boolean;\n  // submission_idx for pagination, inclusive\n  idx?: string;\n  max_time?: number;\n  limit?:\n    | {\n        raw: number;\n      }\n    | {\n        txs: number;\n      };\n}\n\nexport type IndexerServerTriggerTypeFilter =\n  | 'none'\n  | 'price_trigger'\n  | 'time_trigger';\n\nexport interface IndexerServerOrdersParams {\n  subaccounts?: string[];\n  product_ids?: number[];\n  trigger_types?: IndexerServerTriggerTypeFilter[];\n  digests?: string[];\n  max_time?: number;\n  limit?: number;\n  // If not given, will return both isolated & non-iso orders\n  isolated?: boolean;\n  // submission_idx for pagination, inclusive\n  idx?: string;\n}\n\nexport interface IndexerServerMatchEventsParams {\n  subaccounts?: string[];\n  product_ids?: number[];\n  // If not given, will return both isolated & non-iso events\n  isolated?: boolean;\n  max_time?: number;\n  limit: number;\n  // submission_idx for pagination, inclusive\n  idx?: string;\n}\n\nexport interface IndexerServerLinkedSignerParams {\n  subaccount: string;\n}\n\nexport interface IndexerServerMarketSnapshotsParams {\n  interval: IndexerServerMarketSnapshotInterval;\n  // Defaults to all\n  product_ids?: number[];\n}\n\nexport interface IndexerEdgeServerMarketSnapshotsParams {\n  interval: IndexerServerMarketSnapshotInterval;\n}\n\nexport interface IndexerServerInterestFundingParams {\n  subaccount: string;\n  product_ids: number[];\n  // If not given, defaults to latest\n  max_idx?: string;\n  max_time?: number;\n  limit: number;\n}\n\nexport interface IndexerServerMakerStatisticsParams {\n  product_id: number;\n  epoch: number;\n  interval: number;\n}\n\nexport interface IndexerServerLeaderboardParams {\n  contest_id: number;\n  rank_type?: IndexerLeaderboardRankType;\n  start?: number | string;\n  limit?: number | string;\n  order?: 'ASC' | 'DESC';\n}\n\nexport interface IndexerServerLeaderboardRankParams {\n  subaccount: string;\n  contest_ids: number[];\n}\n\nexport interface IndexerServerLeaderboardContestsParams {\n  contest_ids?: number[];\n  active?: boolean;\n}\n\nexport interface IndexerServerLeaderboardRegistrationsParams {\n  subaccount: string;\n  contest_ids?: number[];\n  active?: boolean;\n}\n\nexport interface IndexerServerLeaderboardRegisterParams {\n  update_registration: SignedTx<EIP712LeaderboardAuthenticationValues>;\n}\n\nexport interface IndexerServerSocialConnectParams {\n  update_social_account: SignedTx<EIP712SocialAuthenticationValues>;\n}\n\nexport interface IndexerServerListSocialAccountsParams {\n  address: string;\n}\n\nexport type IndexerServerRevokeSocialAccountParams =\n  IndexerServerSocialConnectParams;\n\nexport interface IndexerServerFastWithdrawalSignatureParams {\n  /**\n   * The submission index of the WithdrawCollateral tx to be used for fast withdraw.\n   */\n  idx: number | string;\n}\n\nexport interface IndexerServerNlpSnapshotsParams {\n  interval: IndexerServerSnapshotsInterval;\n}\n\nexport interface IndexerServerDDAQueryParams {\n  subaccount: string;\n}\n\nexport interface IndexerServerPrivateAlphaChoiceParams {\n  address: string;\n}\n\nexport interface IndexerServerPointsParams {\n  address: string;\n}\n\nexport interface IndexerServerXPointsParams {\n  address: string;\n}\n\nexport interface IndexerServerCashIncentivesParams {\n  wallet_address: string;\n}\n\n// Request\nexport interface IndexerServerQueryRequestByType {\n  account_snapshots: IndexerServerMultiSubaccountSnapshotsParams;\n  backlog: Record<string, never>;\n  candlesticks: IndexerServerCandlesticksParams;\n  direct_deposit_address: IndexerServerDDAQueryParams;\n  edge_candlesticks: IndexerEdgeServerCandlesticksParams;\n  edge_market_snapshots: IndexerEdgeServerMarketSnapshotsParams;\n  events: IndexerServerEventsParams;\n  fast_withdrawal_signature: IndexerServerFastWithdrawalSignatureParams;\n  funding_rate: IndexerServerFundingRateParams;\n  funding_rate_history: IndexerServerFundingRateHistoryParams;\n  funding_rates: IndexerServerFundingRatesParams;\n  interest_and_funding: IndexerServerInterestFundingParams;\n  leaderboard: IndexerServerLeaderboardParams;\n  leaderboard_contests: IndexerServerLeaderboardContestsParams;\n  leaderboard_rank: IndexerServerLeaderboardRankParams;\n  leaderboard_register: IndexerServerLeaderboardRegisterParams;\n  leaderboard_registrations: IndexerServerLeaderboardRegistrationsParams;\n  linked_signer_rate_limit: IndexerServerLinkedSignerParams;\n  maker_statistics: IndexerServerMakerStatisticsParams;\n  market_snapshots: IndexerServerMarketSnapshotsParams;\n  matches: IndexerServerMatchEventsParams;\n  oracle_price: IndexerServerOraclePricesParams;\n  orders: IndexerServerOrdersParams;\n  perp_prices: IndexerServerPerpPricesParams;\n  portfolio: IndexerServerPortfolioParams;\n  price: IndexerServerPriceParams;\n  product_snapshots: IndexerServerMultiProductsParams;\n  products: IndexerServerProductsParams;\n  referral_code: IndexerServerReferralCodeParams;\n  subaccounts: IndexerServerListSubaccountsParams;\n  quote_price: Record<string, never>;\n  nlp_snapshots: IndexerServerNlpSnapshotsParams;\n  private_alpha_choice: IndexerServerPrivateAlphaChoiceParams;\n  nado_points: IndexerServerPointsParams;\n  nado_xpoints: IndexerServerXPointsParams;\n  cash_incentives: IndexerServerCashIncentivesParams;\n  social_connect: IndexerServerSocialConnectParams;\n  list_social_accounts: IndexerServerListSocialAccountsParams;\n  revoke_social_account: IndexerServerRevokeSocialAccountParams;\n}\n\nexport type IndexerServerQueryRequestType =\n  keyof IndexerServerQueryRequestByType;\n\n/**\n * Responses\n */\n\nexport interface IndexerServerListSubaccountsResponse {\n  subaccounts: {\n    id: string;\n    // Hex of subaccount bytes\n    subaccount: string;\n    // UNIX timestamp in seconds\n    created_at: string;\n    isolated: boolean;\n  }[];\n}\n\nexport interface IndexerServerMultiSubaccountSnapshotsResponse {\n  // Map of subaccount hex -> timestamp requested -> latest events corresponding to each product\n  snapshots: Record<string, Record<string, IndexerServerEvent[]>>;\n}\n\nexport interface IndexerServerReferralCodeResponse {\n  referral_code: string | null;\n}\n\nexport interface IndexerServerFundingRate {\n  product_id: number;\n  funding_rate_x18: string;\n  update_time: number;\n}\n\nexport type IndexerServerFundingRateResponse = IndexerServerFundingRate;\n\n// Map of productId -> IndexerServerFundingRate\nexport type IndexerServerFundingRatesResponse = Record<\n  string,\n  IndexerServerFundingRate\n>;\n\nexport interface IndexerServerFundingRateHistoryEntry {\n  product_id: number;\n  // Epoch time in seconds of the settlement tick this funding rate was recorded at.\n  timestamp: string;\n  // Realized hourly funding rate at this tick, multiplied by 10^18 (% = rate * 100).\n  funding_rate_x18: string;\n}\n\nexport interface IndexerServerFundingRateHistoryResponse {\n  // Always ascending by timestamp.\n  funding_rates: IndexerServerFundingRateHistoryEntry[];\n}\n\nexport type IndexerServerPortfolioPeriod =\n  | 'day'\n  | 'week'\n  | 'month'\n  | 'allTime'\n  | 'perpDay'\n  | 'perpWeek'\n  | 'perpMonth'\n  | 'perpAllTime';\n\n/**\n * [timestamp (unix seconds), value] — both x18-free decimal strings. Values are\n * USDT0-denominated, except `marketCountHistory` points, which are integer counts.\n */\nexport type IndexerServerPortfolioPoint = [string, string];\n\n// All five series are aligned: same timestamps, same length.\nexport interface IndexerServerPortfolioHistory {\n  accountValueHistory: IndexerServerPortfolioPoint[];\n  pnlHistory: IndexerServerPortfolioPoint[];\n  volumeHistory: IndexerServerPortfolioPoint[];\n  tradeSizeHistory: IndexerServerPortfolioPoint[];\n  marketCountHistory: IndexerServerPortfolioPoint[];\n}\n\nexport type IndexerServerPortfolioResponse = [\n  IndexerServerPortfolioPeriod,\n  IndexerServerPortfolioHistory,\n][];\n\nexport interface IndexerServerPerpPrices {\n  product_id: number;\n  index_price_x18: string;\n  mark_price_x18: string;\n  update_time: number;\n}\n\nexport type IndexerServerPriceResponse = IndexerServerPerpPrices;\n\n// Map of productId -> IndexerServerPerpPrices\nexport type IndexerServerPerpPricesResponse = Record<\n  string,\n  IndexerServerPerpPrices\n>;\n\nexport interface IndexerServerOraclePricesResponse {\n  prices: IndexerServerOraclePrice[];\n}\n\nexport interface IndexerServerCandlesticksResponse {\n  candlesticks: IndexerServerCandlestick[];\n}\n\nexport type IndexerEdgeServerCandlesticksResponse =\n  IndexerServerCandlesticksResponse;\n\nexport interface IndexerServerProductsResponse {\n  products: IndexerServerProductSnapshot[];\n  txs: IndexerServerTx[];\n}\n\n// Map of timestamp -> (productID -> IndexerServerProductSnapshot)\nexport type IndexerServerMultiProductsResponse = Record<\n  string,\n  Record<string, IndexerServerProductSnapshot>\n>;\n\nexport interface IndexerServerEventsResponse {\n  events: IndexerServerEvent[];\n  txs: IndexerServerTx[];\n}\n\nexport interface IndexerServerOrdersResponse {\n  orders: IndexerServerOrder[];\n}\n\nexport interface IndexerServerMatchEventsResponse {\n  matches: IndexerServerMatchEvent[];\n  txs: IndexerServerTx[];\n}\n\nexport interface IndexerServerQuotePriceResponse {\n  price_x18: string;\n}\n\nexport interface IndexerServerLinkedSignerResponse {\n  total_tx_limit: string;\n  remaining_tx: string;\n  wait_time: string;\n  signer: string;\n}\n\nexport interface IndexerServerMarketSnapshotsResponse {\n  snapshots: IndexerServerMarketSnapshot[];\n}\n\nexport interface IndexerEdgeServerMarketSnapshotsResponse {\n  snapshots: Record<number, IndexerServerMarketSnapshot[]>;\n}\n\nexport interface IndexerServerInterestFundingResponse {\n  interest_payments: IndexerServerProductPayment[];\n  funding_payments: IndexerServerProductPayment[];\n  next_idx: string;\n}\n\nexport interface IndexerServerMakerStatisticsResponse {\n  reward_coefficient: string;\n  makers: IndexerServerMaker[];\n}\n\nexport interface IndexerServerLeaderboardResponse {\n  positions: IndexerServerLeaderboardPosition[];\n}\n\nexport interface IndexerServerLeaderboardRegistrationsResponse {\n  registrations: IndexerServerLeaderboardRegistration[];\n}\n\nexport type IndexerServerLeaderboardRegisterResponse =\n  IndexerServerLeaderboardRegistrationsResponse;\n\nexport interface IndexerServerLeaderboardRankResponse {\n  // If the subaccount is not eligible for a given contest, it would not be included in the response.\n  // contestId -> IndexerServerLeaderboardPosition\n  positions: Record<string, IndexerServerLeaderboardPosition>;\n}\n\nexport interface IndexerServerLeaderboardContestsResponse {\n  contests: IndexerServerLeaderboardContest[];\n}\n\nexport interface IndexerServerFastWithdrawalSignatureResponse {\n  idx: string;\n  tx: NadoWithdrawCollateralTx['withdraw_collateral'];\n  // Present only for `WithdrawCollateralV2` withdrawals.\n  tx_v2?: NadoWithdrawCollateralV2Tx['withdraw_collateral_v2'];\n  tx_bytes: string;\n  signatures: string[];\n}\n\nexport interface IndexerServerNlpSnapshotsResponse {\n  snapshots: IndexerServerNlpSnapshot[];\n}\n\nexport interface IndexerServerDDAResponse {\n  v1_address: string;\n}\n\nexport interface IndexerServerBacklogResponse {\n  // Total number of transactions stored in the indexer DB\n  total_txs: string;\n  // Current nSubmissions value from the chain (i.e., number of processed txs)\n  total_submissions: string;\n  // Number of unprocessed transactions (total_txs - total_submissions)\n  backlog_size: string;\n  // UNIX timestamp (in seconds) of when the data was last updated\n  updated_at: string;\n  // Estimated time in seconds (float) to clear the entire backlog (null if unavailable)\n  backlog_eta_in_seconds: string | null;\n  // Current submission rate in transactions per second (float) (null if unavailable)\n  txs_per_second: string | null;\n}\n\nexport interface IndexerServerPrivateAlphaChoiceResponse {\n  points: string;\n  fee_refund: string;\n  nft_eligibility: boolean;\n}\n\nexport interface IndexerServerPointsEpoch {\n  epoch: number;\n  description: string;\n  start_time: string;\n  end_time: string;\n  total_points: string;\n  points: string;\n  rank: number;\n  tier: number;\n}\n\nexport interface IndexerServerAllTimePoints {\n  points: string;\n  rank: number;\n  tier: number;\n}\n\nexport interface IndexerServerPointsResponse {\n  points_per_epoch: IndexerServerPointsEpoch[];\n  all_time_points: IndexerServerAllTimePoints;\n}\n\nexport interface IndexerServerXPointsQuest {\n  quest_type: string;\n  points: string;\n}\n\nexport interface IndexerServerXPointsEpoch {\n  epoch: number;\n  description: string;\n  start_time: string;\n  end_time: string;\n  total_points: string;\n  rank: number;\n  quests: IndexerServerXPointsQuest[];\n}\n\nexport interface IndexerServerXPointsAllTime {\n  total_points: string;\n  rank: number;\n  quests: IndexerServerXPointsQuest[];\n}\n\nexport interface IndexerServerXPointsResponse {\n  points_per_epoch: IndexerServerXPointsEpoch[];\n  all_time_points: IndexerServerXPointsAllTime;\n}\n\nexport interface IndexerServerCashIncentivesEventMetadata {\n  event_id: number;\n  description: string;\n  // UNIX timestamp in seconds\n  epoch_start: string;\n  // UNIX timestamp in seconds\n  epoch_end: string;\n  // x18 string\n  max_volume: string;\n  // x18 string\n  max_reward: string;\n  // x18 string\n  min_volume: string;\n  // x18 string\n  min_reward: string;\n}\n\nexport interface IndexerServerCashIncentivesEventPlatform {\n  // x18 string\n  platform_volume: string;\n  // x18 string\n  unlocked_reward: string;\n}\n\n/**\n * Claim status of a wallet for a single Cash Incentives event.\n *\n * - `in_progress`: the event is still active.\n * - `pending`: the event has ended, but its settlement has not been published.\n * - `no_reward`: the settlement exists, but the wallet has no reward.\n * - `claimable`: the settlement grants this wallet a reward, and the proof to claim it is included.\n *\n * There is deliberately no `claimed` status. The airdrop contract's `getClaimed` is the source of\n * truth for whether a reward has already been taken, so a reward stays `claimable` here even after\n * it has been claimed onchain.\n */\nexport const INDEXER_SERVER_CASH_INCENTIVES_WALLET_STATUSES = [\n  'in_progress',\n  'pending',\n  'no_reward',\n  'claimable',\n] as const;\n\nexport type IndexerServerCashIncentivesWalletStatus =\n  (typeof INDEXER_SERVER_CASH_INCENTIVES_WALLET_STATUSES)[number];\n\n/**\n * `wallet.claim` variant carrying everything needed to claim onchain.\n */\nexport interface IndexerServerCashIncentivesClaimableClaim {\n  status: 'claimable';\n  airdrop_address: string;\n  // Reward event id within the airdrop contract, distinct from `metadata.event_id`\n  week: number;\n  // Integer string in raw token units, as committed to by the merkle root\n  total_amount: string;\n  // Merkle proof hashes\n  proof: string[];\n}\n\n/**\n * `wallet.claim` variant for events with nothing to claim, which carries only the status.\n */\nexport interface IndexerServerCashIncentivesUnclaimableClaim {\n  status: Exclude<IndexerServerCashIncentivesWalletStatus, 'claimable'>;\n}\n\n/**\n * Always present, tagged on `status`. Only the `claimable` variant carries proof data.\n */\nexport type IndexerServerCashIncentivesWalletClaim =\n  | IndexerServerCashIncentivesClaimableClaim\n  | IndexerServerCashIncentivesUnclaimableClaim;\n\nexport interface IndexerServerCashIncentivesEventWallet {\n  // x18 string\n  reward: string;\n  claim: IndexerServerCashIncentivesWalletClaim;\n}\n\nexport interface IndexerServerCashIncentivesEvent {\n  metadata: IndexerServerCashIncentivesEventMetadata;\n  platform: IndexerServerCashIncentivesEventPlatform;\n  wallet: IndexerServerCashIncentivesEventWallet;\n}\n\nexport interface IndexerServerCashIncentivesWalletSummary {\n  // x18 string\n  total_reward: string;\n  // x18 string\n  claimable_reward: string;\n}\n\nexport interface IndexerServerCashIncentivesResponse {\n  events: IndexerServerCashIncentivesEvent[];\n  wallet_summary: IndexerServerCashIncentivesWalletSummary;\n}\n\nexport interface IndexerServerSocialConnectResponse {\n  url: string;\n}\n\nexport interface IndexerServerSocialAccountsResponse {\n  accounts: IndexerServerSocialAccount[];\n}\n\n// Response\nexport interface IndexerServerQueryResponseByType {\n  account_snapshots: IndexerServerMultiSubaccountSnapshotsResponse;\n  backlog: IndexerServerBacklogResponse;\n  candlesticks: IndexerServerCandlesticksResponse;\n  direct_deposit_address: IndexerServerDDAResponse;\n  edge_candlesticks: IndexerEdgeServerCandlesticksResponse;\n  edge_market_snapshots: IndexerEdgeServerMarketSnapshotsResponse;\n  events: IndexerServerEventsResponse;\n  fast_withdrawal_signature: IndexerServerFastWithdrawalSignatureResponse;\n  funding_rate: IndexerServerFundingRateResponse;\n  funding_rate_history: IndexerServerFundingRateHistoryResponse;\n  funding_rates: IndexerServerFundingRatesResponse;\n  interest_and_funding: IndexerServerInterestFundingResponse;\n  leaderboard: IndexerServerLeaderboardResponse;\n  leaderboard_contests: IndexerServerLeaderboardContestsResponse;\n  leaderboard_rank: IndexerServerLeaderboardRankResponse;\n  leaderboard_register: IndexerServerLeaderboardRegisterResponse;\n  leaderboard_registrations: IndexerServerLeaderboardRegistrationsResponse;\n  linked_signer_rate_limit: IndexerServerLinkedSignerResponse;\n  maker_statistics: IndexerServerMakerStatisticsResponse;\n  market_snapshots: IndexerServerMarketSnapshotsResponse;\n  matches: IndexerServerMatchEventsResponse;\n  oracle_price: IndexerServerOraclePricesResponse;\n  orders: IndexerServerOrdersResponse;\n  perp_prices: IndexerServerPerpPricesResponse;\n  portfolio: IndexerServerPortfolioResponse;\n  price: IndexerServerPriceResponse;\n  product_snapshots: IndexerServerMultiProductsResponse;\n  products: IndexerServerProductsResponse;\n  referral_code: IndexerServerReferralCodeResponse;\n  subaccounts: IndexerServerListSubaccountsResponse;\n  quote_price: IndexerServerQuotePriceResponse;\n  nlp_snapshots: IndexerServerNlpSnapshotsResponse;\n  private_alpha_choice: IndexerServerPrivateAlphaChoiceResponse;\n  nado_points: IndexerServerPointsResponse;\n  nado_xpoints: IndexerServerXPointsResponse;\n  cash_incentives: IndexerServerCashIncentivesResponse;\n  social_connect: IndexerServerSocialConnectResponse;\n  list_social_accounts: IndexerServerSocialAccountsResponse;\n  revoke_social_account: IndexerServerSocialAccountsResponse;\n}\n\n/**\n * V2 API Types\n */\n\n/**\n * Individual ticker data from v2 indexer endpoint (server format)\n */\nexport interface IndexerServerV2TickerResponse {\n  product_id: number;\n  ticker_id: string;\n  base_currency: string;\n  quote_currency: string;\n  last_price: number;\n  base_volume: number;\n  quote_volume: number;\n  price_change_percent_24h: number;\n}\n\n/**\n * Response from v2 tickers endpoint (server format)\n * Maps ticker IDs to their respective ticker data\n */\nexport type IndexerServerV2TickersResponse = Record<\n  string,\n  IndexerServerV2TickerResponse\n>;\n\n/**\n * Market hours data from v2 symbols endpoint (server format)\n */\nexport interface IndexerServerV2MarketHours {\n  is_open: boolean;\n  reason: string | null;\n  next_close: string | null;\n  next_open: string | null;\n}\n\n/**\n * Individual symbol data from v2 indexer endpoint (server format)\n */\nexport interface IndexerServerV2Symbol {\n  type: string;\n  product_id: number;\n  symbol: string;\n  price_increment_x18: string;\n  size_increment: string;\n  min_size: string;\n  maker_fee_rate_x18: string;\n  taker_fee_rate_x18: string;\n  long_weight_initial_x18: string;\n  long_weight_maintenance_x18: string;\n  /**\n   * Defined only for perp markets with a max OI cap\n   */\n  max_open_interest_x18: string | null;\n  /**\n   * Defined only for xStocks spot markets\n   */\n  exchange_rate_x18: string | null;\n  trading_status: string;\n  isolated_only: boolean;\n  market_hours: IndexerServerV2MarketHours | null;\n  /**\n   * Boost tier for products with rewards boosts. Null for non-boosted products.\n   * 0 = none, 1 = taker 4x / maker 4x, 2 = taker 3x / maker 4x\n   */\n  boost_type: number | null;\n  /**\n   * Taker rewards multiplier. Null for non-boosted products.\n   */\n  taker_multiplier: number | null;\n  /**\n   * Maker rewards multiplier. Null for non-boosted products.\n   */\n  maker_multiplier: number | null;\n}\n\n/**\n * Response from v2 symbols endpoint (server format)\n * Maps symbols to their respective data\n */\nexport type IndexerServerV2SymbolsResponse = Record<\n  string,\n  IndexerServerV2Symbol\n>;\n\n/**\n * Wire `request_type` the indexer echoes on failure envelopes. The indexer's failure envelope is\n * keyed by route (`<verb>_<query_type>`), mirroring the engine and trigger services. Kept as a\n * `${string}_${string}` template to avoid enumerating the full set of v1 query types declared\n * above.\n */\nexport type IndexerServerRequestType = `${string}_${string}`;\n\n/**\n * Failure envelope returned by the indexer service API. Mirrors the failure shape used by the\n * engine and trigger services: a `status: 'failure'` discriminant plus an `error`/`error_code`\n * pair and the originating `request_type`. A response missing this envelope shape (e.g. a\n * malformed body, or a non-JSON response) is a transport-level error, not a domain error.\n *\n * The v2 REST endpoints do not return this envelope — they use plain HTTP error responses\n * without an `error_code` field.\n */\nexport interface IndexerServerFailureResponse {\n  status: 'failure';\n  error: string;\n  error_code: number;\n  request_type: IndexerServerRequestType;\n}\n\n/**\n * Narrows an unknown response body to the indexer service API failure envelope.\n */\nexport function isIndexerServerFailureResponse(\n  data: unknown,\n): data is IndexerServerFailureResponse {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as Record<string, unknown>).status === 'failure'\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AA+lBA,MAAa,iDAAiD;CAC5D;CACA;CACA;CACA;AACF;;;;AA6NA,SAAgB,+BACd,MACsC;CACtC,OACE,OAAO,SAAS,YAChB,SAAS,QACR,KAAiC,WAAW;AAEjD"}
+{"version":3,"file":"serverTypes.js","names":[],"sources":["../../src/types/serverTypes.ts"],"sourcesContent":["import {\n  EIP712LeaderboardAuthenticationValues,\n  EIP712SocialAuthenticationValues,\n  SignedTx,\n} from '@nadohq/shared';\nimport { IndexerEventType } from './IndexerEventType';\nimport { IndexerLeaderboardRankType } from './IndexerLeaderboardType';\nimport { NadoWithdrawCollateralTx, NadoWithdrawCollateralV2Tx } from './NadoTx';\nimport {\n  IndexerServerCandlestick,\n  IndexerServerEvent,\n  IndexerServerLeaderboardContest,\n  IndexerServerLeaderboardPosition,\n  IndexerServerLeaderboardRegistration,\n  IndexerServerMaker,\n  IndexerServerMarketSnapshot,\n  IndexerServerMarketSnapshotInterval,\n  IndexerServerMatchEvent,\n  IndexerServerNlpSnapshot,\n  IndexerServerOraclePrice,\n  IndexerServerOrder,\n  IndexerServerPosition,\n  IndexerServerProductPayment,\n  IndexerServerProductSnapshot,\n  IndexerServerSnapshotsInterval,\n  IndexerServerSocialAccount,\n  IndexerServerTx,\n} from './serverModelTypes';\n\n/**\n * Params\n */\n\nexport interface IndexerServerListSubaccountsParams {\n  // Inclusive, defaults to 0\n  start?: number;\n  // Defaults to 100\n  limit?: number;\n  address?: string;\n}\n\nexport interface IndexerServerMultiSubaccountSnapshotsParams {\n  // Subaccount hex identifiers\n  subaccounts: string[];\n  timestamps: number[];\n  // If not given, will return both isolated & non-iso balances\n  isolated?: boolean;\n}\n\nexport interface IndexerServerReferralCodeParams {\n  subaccount: string;\n}\n\nexport interface IndexerServerFundingRateParams {\n  product_id: number;\n}\n\nexport interface IndexerServerFundingRatesParams {\n  product_ids: number[];\n}\n\nexport interface IndexerServerFundingRateHistoryParams {\n  product_id: number;\n  start_time?: number | string;\n  end_time?: number | string;\n  // Max number of rates to return. Defaults to 100, max 1000.\n  limit?: number;\n}\n\nexport interface IndexerServerPriceParams {\n  product_id: number;\n}\n\nexport interface IndexerServerPerpPricesParams {\n  product_ids: number[];\n}\n\nexport interface IndexerServerPortfolioParams {\n  subaccount: string;\n}\n\nexport interface IndexerServerOraclePricesParams {\n  product_ids: number[];\n}\n\nexport interface IndexerServerCandlesticksParams {\n  product_id: number;\n  granularity: number;\n  // Seconds\n  max_time?: number;\n  limit: number;\n}\n\nexport type IndexerEdgeServerCandlesticksParams =\n  IndexerServerCandlesticksParams;\n\nexport interface IndexerServerProductsParams {\n  product_id: number;\n  max_time?: number;\n  limit: number;\n  // submission_idx for pagination, inclusive\n  idx?: string;\n}\n\nexport interface IndexerServerMultiProductsParams {\n  product_ids: number[];\n  max_time: number[];\n}\n\nexport interface IndexerServerEventsParams {\n  subaccounts?: string[];\n  product_ids?: number[];\n  // If not given, will return both isolated & non-iso events\n  isolated?: boolean;\n  event_types?: IndexerEventType[];\n  // Descending order for idx (time), defaults to true\n  desc?: boolean;\n  // submission_idx for pagination, inclusive\n  idx?: string;\n  max_time?: number;\n  limit?:\n    | {\n        raw: number;\n      }\n    | {\n        txs: number;\n      };\n}\n\nexport type IndexerServerTriggerTypeFilter =\n  | 'none'\n  | 'price_trigger'\n  | 'time_trigger';\n\nexport interface IndexerServerOrdersParams {\n  subaccounts?: string[];\n  product_ids?: number[];\n  trigger_types?: IndexerServerTriggerTypeFilter[];\n  digests?: string[];\n  max_time?: number;\n  limit?: number;\n  // If not given, will return both isolated & non-iso orders\n  isolated?: boolean;\n  // submission_idx for pagination, inclusive\n  idx?: string;\n}\n\nexport interface IndexerServerMatchEventsParams {\n  subaccounts?: string[];\n  product_ids?: number[];\n  // If not given, will return both isolated & non-iso events\n  isolated?: boolean;\n  max_time?: number;\n  limit: number;\n  // submission_idx for pagination, inclusive\n  idx?: string;\n}\n\n/**\n * Params for the positions query. All parameters except `subaccount` are optional filters.\n */\nexport interface IndexerServerPositionsParams {\n  // Subaccount hex identifier. Isolated positions are also returned under the parent subaccount\n  subaccount: string;\n  // When provided, only return positions of the specified product\n  product_id?: number;\n  // If not given, will return both isolated & cross positions\n  isolated?: boolean;\n  // If not given, will return both open & closed positions\n  open?: boolean;\n  // open_id for pagination, inclusive (only positions with open_id <= idx are returned)\n  idx?: number | string;\n  // Max number of positions to return. Defaults to 100, max 500\n  limit?: number;\n}\n\nexport interface IndexerServerLinkedSignerParams {\n  subaccount: string;\n}\n\nexport interface IndexerServerMarketSnapshotsParams {\n  interval: IndexerServerMarketSnapshotInterval;\n  // Defaults to all\n  product_ids?: number[];\n}\n\nexport interface IndexerEdgeServerMarketSnapshotsParams {\n  interval: IndexerServerMarketSnapshotInterval;\n}\n\nexport interface IndexerServerInterestFundingParams {\n  subaccount: string;\n  product_ids: number[];\n  // If not given, defaults to latest\n  max_idx?: string;\n  max_time?: number;\n  limit: number;\n}\n\nexport interface IndexerServerMakerStatisticsParams {\n  product_id: number;\n  epoch: number;\n  interval: number;\n}\n\nexport interface IndexerServerLeaderboardParams {\n  contest_id: number;\n  rank_type?: IndexerLeaderboardRankType;\n  start?: number | string;\n  limit?: number | string;\n  order?: 'ASC' | 'DESC';\n}\n\nexport interface IndexerServerLeaderboardRankParams {\n  subaccount: string;\n  contest_ids: number[];\n}\n\nexport interface IndexerServerLeaderboardContestsParams {\n  contest_ids?: number[];\n  active?: boolean;\n}\n\nexport interface IndexerServerLeaderboardRegistrationsParams {\n  subaccount: string;\n  contest_ids?: number[];\n  active?: boolean;\n}\n\nexport interface IndexerServerLeaderboardRegisterParams {\n  update_registration: SignedTx<EIP712LeaderboardAuthenticationValues>;\n}\n\nexport interface IndexerServerSocialConnectParams {\n  update_social_account: SignedTx<EIP712SocialAuthenticationValues>;\n}\n\nexport interface IndexerServerListSocialAccountsParams {\n  address: string;\n}\n\nexport type IndexerServerRevokeSocialAccountParams =\n  IndexerServerSocialConnectParams;\n\nexport interface IndexerServerFastWithdrawalSignatureParams {\n  /**\n   * The submission index of the WithdrawCollateral tx to be used for fast withdraw.\n   */\n  idx: number | string;\n}\n\nexport interface IndexerServerNlpSnapshotsParams {\n  interval: IndexerServerSnapshotsInterval;\n}\n\nexport interface IndexerServerDDAQueryParams {\n  subaccount: string;\n}\n\nexport interface IndexerServerPrivateAlphaChoiceParams {\n  address: string;\n}\n\nexport interface IndexerServerPointsParams {\n  address: string;\n}\n\nexport interface IndexerServerXPointsParams {\n  address: string;\n}\n\nexport interface IndexerServerCashIncentivesParams {\n  wallet_address: string;\n}\n\n// Request\nexport interface IndexerServerQueryRequestByType {\n  account_snapshots: IndexerServerMultiSubaccountSnapshotsParams;\n  backlog: Record<string, never>;\n  candlesticks: IndexerServerCandlesticksParams;\n  direct_deposit_address: IndexerServerDDAQueryParams;\n  edge_candlesticks: IndexerEdgeServerCandlesticksParams;\n  edge_market_snapshots: IndexerEdgeServerMarketSnapshotsParams;\n  events: IndexerServerEventsParams;\n  fast_withdrawal_signature: IndexerServerFastWithdrawalSignatureParams;\n  funding_rate: IndexerServerFundingRateParams;\n  funding_rate_history: IndexerServerFundingRateHistoryParams;\n  funding_rates: IndexerServerFundingRatesParams;\n  interest_and_funding: IndexerServerInterestFundingParams;\n  leaderboard: IndexerServerLeaderboardParams;\n  leaderboard_contests: IndexerServerLeaderboardContestsParams;\n  leaderboard_rank: IndexerServerLeaderboardRankParams;\n  leaderboard_register: IndexerServerLeaderboardRegisterParams;\n  leaderboard_registrations: IndexerServerLeaderboardRegistrationsParams;\n  linked_signer_rate_limit: IndexerServerLinkedSignerParams;\n  maker_statistics: IndexerServerMakerStatisticsParams;\n  market_snapshots: IndexerServerMarketSnapshotsParams;\n  matches: IndexerServerMatchEventsParams;\n  oracle_price: IndexerServerOraclePricesParams;\n  orders: IndexerServerOrdersParams;\n  perp_prices: IndexerServerPerpPricesParams;\n  portfolio: IndexerServerPortfolioParams;\n  positions: IndexerServerPositionsParams;\n  price: IndexerServerPriceParams;\n  product_snapshots: IndexerServerMultiProductsParams;\n  products: IndexerServerProductsParams;\n  referral_code: IndexerServerReferralCodeParams;\n  subaccounts: IndexerServerListSubaccountsParams;\n  quote_price: Record<string, never>;\n  nlp_snapshots: IndexerServerNlpSnapshotsParams;\n  private_alpha_choice: IndexerServerPrivateAlphaChoiceParams;\n  nado_points: IndexerServerPointsParams;\n  nado_xpoints: IndexerServerXPointsParams;\n  cash_incentives: IndexerServerCashIncentivesParams;\n  social_connect: IndexerServerSocialConnectParams;\n  list_social_accounts: IndexerServerListSocialAccountsParams;\n  revoke_social_account: IndexerServerRevokeSocialAccountParams;\n}\n\nexport type IndexerServerQueryRequestType =\n  keyof IndexerServerQueryRequestByType;\n\n/**\n * Responses\n */\n\nexport interface IndexerServerListSubaccountsResponse {\n  subaccounts: {\n    id: string;\n    // Hex of subaccount bytes\n    subaccount: string;\n    // UNIX timestamp in seconds\n    created_at: string;\n    isolated: boolean;\n  }[];\n}\n\nexport interface IndexerServerMultiSubaccountSnapshotsResponse {\n  // Map of subaccount hex -> timestamp requested -> latest events corresponding to each product\n  snapshots: Record<string, Record<string, IndexerServerEvent[]>>;\n}\n\nexport interface IndexerServerReferralCodeResponse {\n  referral_code: string | null;\n}\n\nexport interface IndexerServerFundingRate {\n  product_id: number;\n  funding_rate_x18: string;\n  update_time: number;\n}\n\nexport type IndexerServerFundingRateResponse = IndexerServerFundingRate;\n\n// Map of productId -> IndexerServerFundingRate\nexport type IndexerServerFundingRatesResponse = Record<\n  string,\n  IndexerServerFundingRate\n>;\n\nexport interface IndexerServerFundingRateHistoryEntry {\n  product_id: number;\n  // Epoch time in seconds of the settlement tick this funding rate was recorded at.\n  timestamp: string;\n  // Realized hourly funding rate at this tick, multiplied by 10^18 (% = rate * 100).\n  funding_rate_x18: string;\n}\n\nexport interface IndexerServerFundingRateHistoryResponse {\n  // Always ascending by timestamp.\n  funding_rates: IndexerServerFundingRateHistoryEntry[];\n}\n\nexport type IndexerServerPortfolioPeriod =\n  | 'day'\n  | 'week'\n  | 'month'\n  | 'allTime'\n  | 'perpDay'\n  | 'perpWeek'\n  | 'perpMonth'\n  | 'perpAllTime';\n\n/**\n * [timestamp (unix seconds), value] — both x18-free decimal strings. Values are\n * USDT0-denominated, except `marketCountHistory` points, which are integer counts.\n */\nexport type IndexerServerPortfolioPoint = [string, string];\n\n// All five series are aligned: same timestamps, same length.\nexport interface IndexerServerPortfolioHistory {\n  accountValueHistory: IndexerServerPortfolioPoint[];\n  pnlHistory: IndexerServerPortfolioPoint[];\n  volumeHistory: IndexerServerPortfolioPoint[];\n  tradeSizeHistory: IndexerServerPortfolioPoint[];\n  marketCountHistory: IndexerServerPortfolioPoint[];\n}\n\nexport type IndexerServerPortfolioResponse = [\n  IndexerServerPortfolioPeriod,\n  IndexerServerPortfolioHistory,\n][];\n\nexport interface IndexerServerPerpPrices {\n  product_id: number;\n  index_price_x18: string;\n  mark_price_x18: string;\n  update_time: number;\n}\n\nexport type IndexerServerPriceResponse = IndexerServerPerpPrices;\n\n// Map of productId -> IndexerServerPerpPrices\nexport type IndexerServerPerpPricesResponse = Record<\n  string,\n  IndexerServerPerpPrices\n>;\n\nexport interface IndexerServerOraclePricesResponse {\n  prices: IndexerServerOraclePrice[];\n}\n\nexport interface IndexerServerCandlesticksResponse {\n  candlesticks: IndexerServerCandlestick[];\n}\n\nexport type IndexerEdgeServerCandlesticksResponse =\n  IndexerServerCandlesticksResponse;\n\nexport interface IndexerServerProductsResponse {\n  products: IndexerServerProductSnapshot[];\n  txs: IndexerServerTx[];\n}\n\n// Map of timestamp -> (productID -> IndexerServerProductSnapshot)\nexport type IndexerServerMultiProductsResponse = Record<\n  string,\n  Record<string, IndexerServerProductSnapshot>\n>;\n\nexport interface IndexerServerEventsResponse {\n  events: IndexerServerEvent[];\n  txs: IndexerServerTx[];\n}\n\nexport interface IndexerServerOrdersResponse {\n  orders: IndexerServerOrder[];\n}\n\nexport interface IndexerServerMatchEventsResponse {\n  matches: IndexerServerMatchEvent[];\n  txs: IndexerServerTx[];\n}\n\n/**\n * Response for the positions query. Positions are in descending order by `open_id`.\n * `events` / `txs` are the events and transactions at each position's boundaries\n * (open and close, or open and latest update while still open), joined to positions\n * via `open_id` / `close_id` / `submission_idx`.\n */\nexport interface IndexerServerPositionsResponse {\n  positions: IndexerServerPosition[];\n  events: IndexerServerEvent[];\n  txs: IndexerServerTx[];\n}\n\nexport interface IndexerServerQuotePriceResponse {\n  price_x18: string;\n}\n\nexport interface IndexerServerLinkedSignerResponse {\n  total_tx_limit: string;\n  remaining_tx: string;\n  wait_time: string;\n  signer: string;\n}\n\nexport interface IndexerServerMarketSnapshotsResponse {\n  snapshots: IndexerServerMarketSnapshot[];\n}\n\nexport interface IndexerEdgeServerMarketSnapshotsResponse {\n  snapshots: Record<number, IndexerServerMarketSnapshot[]>;\n}\n\nexport interface IndexerServerInterestFundingResponse {\n  interest_payments: IndexerServerProductPayment[];\n  funding_payments: IndexerServerProductPayment[];\n  next_idx: string;\n}\n\nexport interface IndexerServerMakerStatisticsResponse {\n  reward_coefficient: string;\n  makers: IndexerServerMaker[];\n}\n\nexport interface IndexerServerLeaderboardResponse {\n  positions: IndexerServerLeaderboardPosition[];\n}\n\nexport interface IndexerServerLeaderboardRegistrationsResponse {\n  registrations: IndexerServerLeaderboardRegistration[];\n}\n\nexport type IndexerServerLeaderboardRegisterResponse =\n  IndexerServerLeaderboardRegistrationsResponse;\n\nexport interface IndexerServerLeaderboardRankResponse {\n  // If the subaccount is not eligible for a given contest, it would not be included in the response.\n  // contestId -> IndexerServerLeaderboardPosition\n  positions: Record<string, IndexerServerLeaderboardPosition>;\n}\n\nexport interface IndexerServerLeaderboardContestsResponse {\n  contests: IndexerServerLeaderboardContest[];\n}\n\nexport interface IndexerServerFastWithdrawalSignatureResponse {\n  idx: string;\n  tx: NadoWithdrawCollateralTx['withdraw_collateral'];\n  // Present only for `WithdrawCollateralV2` withdrawals.\n  tx_v2?: NadoWithdrawCollateralV2Tx['withdraw_collateral_v2'];\n  tx_bytes: string;\n  signatures: string[];\n}\n\nexport interface IndexerServerNlpSnapshotsResponse {\n  snapshots: IndexerServerNlpSnapshot[];\n}\n\nexport interface IndexerServerDDAResponse {\n  v1_address: string;\n}\n\nexport interface IndexerServerBacklogResponse {\n  // Total number of transactions stored in the indexer DB\n  total_txs: string;\n  // Current nSubmissions value from the chain (i.e., number of processed txs)\n  total_submissions: string;\n  // Number of unprocessed transactions (total_txs - total_submissions)\n  backlog_size: string;\n  // UNIX timestamp (in seconds) of when the data was last updated\n  updated_at: string;\n  // Estimated time in seconds (float) to clear the entire backlog (null if unavailable)\n  backlog_eta_in_seconds: string | null;\n  // Current submission rate in transactions per second (float) (null if unavailable)\n  txs_per_second: string | null;\n}\n\nexport interface IndexerServerPrivateAlphaChoiceResponse {\n  points: string;\n  fee_refund: string;\n  nft_eligibility: boolean;\n}\n\nexport interface IndexerServerPointsEpoch {\n  epoch: number;\n  description: string;\n  start_time: string;\n  end_time: string;\n  total_points: string;\n  points: string;\n  rank: number;\n  tier: number;\n}\n\nexport interface IndexerServerAllTimePoints {\n  points: string;\n  rank: number;\n  tier: number;\n}\n\nexport interface IndexerServerPointsResponse {\n  points_per_epoch: IndexerServerPointsEpoch[];\n  all_time_points: IndexerServerAllTimePoints;\n}\n\nexport interface IndexerServerXPointsQuest {\n  quest_type: string;\n  points: string;\n}\n\nexport interface IndexerServerXPointsEpoch {\n  epoch: number;\n  description: string;\n  start_time: string;\n  end_time: string;\n  total_points: string;\n  rank: number;\n  quests: IndexerServerXPointsQuest[];\n}\n\nexport interface IndexerServerXPointsAllTime {\n  total_points: string;\n  rank: number;\n  quests: IndexerServerXPointsQuest[];\n}\n\nexport interface IndexerServerXPointsResponse {\n  points_per_epoch: IndexerServerXPointsEpoch[];\n  all_time_points: IndexerServerXPointsAllTime;\n}\n\nexport interface IndexerServerCashIncentivesEventMetadata {\n  event_id: number;\n  description: string;\n  // UNIX timestamp in seconds\n  epoch_start: string;\n  // UNIX timestamp in seconds\n  epoch_end: string;\n  // x18 string\n  max_volume: string;\n  // x18 string\n  max_reward: string;\n  // x18 string\n  min_volume: string;\n  // x18 string\n  min_reward: string;\n}\n\nexport interface IndexerServerCashIncentivesEventPlatform {\n  // x18 string\n  platform_volume: string;\n  // x18 string\n  unlocked_reward: string;\n}\n\n/**\n * Claim status of a wallet for a single Cash Incentives event.\n *\n * - `in_progress`: the event is still active.\n * - `pending`: the event has ended, but its settlement has not been published.\n * - `no_reward`: the settlement exists, but the wallet has no reward.\n * - `claimable`: the settlement grants this wallet a reward, and the proof to claim it is included.\n *\n * There is deliberately no `claimed` status. The airdrop contract's `getClaimed` is the source of\n * truth for whether a reward has already been taken, so a reward stays `claimable` here even after\n * it has been claimed onchain.\n */\nexport const INDEXER_SERVER_CASH_INCENTIVES_WALLET_STATUSES = [\n  'in_progress',\n  'pending',\n  'no_reward',\n  'claimable',\n] as const;\n\nexport type IndexerServerCashIncentivesWalletStatus =\n  (typeof INDEXER_SERVER_CASH_INCENTIVES_WALLET_STATUSES)[number];\n\n/**\n * `wallet.claim` variant carrying everything needed to claim onchain.\n */\nexport interface IndexerServerCashIncentivesClaimableClaim {\n  status: 'claimable';\n  airdrop_address: string;\n  // Reward event id within the airdrop contract, distinct from `metadata.event_id`\n  week: number;\n  // Integer string in raw token units, as committed to by the merkle root\n  total_amount: string;\n  // Merkle proof hashes\n  proof: string[];\n}\n\n/**\n * `wallet.claim` variant for events with nothing to claim, which carries only the status.\n */\nexport interface IndexerServerCashIncentivesUnclaimableClaim {\n  status: Exclude<IndexerServerCashIncentivesWalletStatus, 'claimable'>;\n}\n\n/**\n * Always present, tagged on `status`. Only the `claimable` variant carries proof data.\n */\nexport type IndexerServerCashIncentivesWalletClaim =\n  | IndexerServerCashIncentivesClaimableClaim\n  | IndexerServerCashIncentivesUnclaimableClaim;\n\nexport interface IndexerServerCashIncentivesEventWallet {\n  // x18 string\n  reward: string;\n  claim: IndexerServerCashIncentivesWalletClaim;\n}\n\nexport interface IndexerServerCashIncentivesEvent {\n  metadata: IndexerServerCashIncentivesEventMetadata;\n  platform: IndexerServerCashIncentivesEventPlatform;\n  wallet: IndexerServerCashIncentivesEventWallet;\n}\n\nexport interface IndexerServerCashIncentivesWalletSummary {\n  // x18 string\n  total_reward: string;\n  // x18 string\n  claimable_reward: string;\n}\n\nexport interface IndexerServerCashIncentivesResponse {\n  events: IndexerServerCashIncentivesEvent[];\n  wallet_summary: IndexerServerCashIncentivesWalletSummary;\n}\n\nexport interface IndexerServerSocialConnectResponse {\n  url: string;\n}\n\nexport interface IndexerServerSocialAccountsResponse {\n  accounts: IndexerServerSocialAccount[];\n}\n\n// Response\nexport interface IndexerServerQueryResponseByType {\n  account_snapshots: IndexerServerMultiSubaccountSnapshotsResponse;\n  backlog: IndexerServerBacklogResponse;\n  candlesticks: IndexerServerCandlesticksResponse;\n  direct_deposit_address: IndexerServerDDAResponse;\n  edge_candlesticks: IndexerEdgeServerCandlesticksResponse;\n  edge_market_snapshots: IndexerEdgeServerMarketSnapshotsResponse;\n  events: IndexerServerEventsResponse;\n  fast_withdrawal_signature: IndexerServerFastWithdrawalSignatureResponse;\n  funding_rate: IndexerServerFundingRateResponse;\n  funding_rate_history: IndexerServerFundingRateHistoryResponse;\n  funding_rates: IndexerServerFundingRatesResponse;\n  interest_and_funding: IndexerServerInterestFundingResponse;\n  leaderboard: IndexerServerLeaderboardResponse;\n  leaderboard_contests: IndexerServerLeaderboardContestsResponse;\n  leaderboard_rank: IndexerServerLeaderboardRankResponse;\n  leaderboard_register: IndexerServerLeaderboardRegisterResponse;\n  leaderboard_registrations: IndexerServerLeaderboardRegistrationsResponse;\n  linked_signer_rate_limit: IndexerServerLinkedSignerResponse;\n  maker_statistics: IndexerServerMakerStatisticsResponse;\n  market_snapshots: IndexerServerMarketSnapshotsResponse;\n  matches: IndexerServerMatchEventsResponse;\n  oracle_price: IndexerServerOraclePricesResponse;\n  orders: IndexerServerOrdersResponse;\n  perp_prices: IndexerServerPerpPricesResponse;\n  portfolio: IndexerServerPortfolioResponse;\n  positions: IndexerServerPositionsResponse;\n  price: IndexerServerPriceResponse;\n  product_snapshots: IndexerServerMultiProductsResponse;\n  products: IndexerServerProductsResponse;\n  referral_code: IndexerServerReferralCodeResponse;\n  subaccounts: IndexerServerListSubaccountsResponse;\n  quote_price: IndexerServerQuotePriceResponse;\n  nlp_snapshots: IndexerServerNlpSnapshotsResponse;\n  private_alpha_choice: IndexerServerPrivateAlphaChoiceResponse;\n  nado_points: IndexerServerPointsResponse;\n  nado_xpoints: IndexerServerXPointsResponse;\n  cash_incentives: IndexerServerCashIncentivesResponse;\n  social_connect: IndexerServerSocialConnectResponse;\n  list_social_accounts: IndexerServerSocialAccountsResponse;\n  revoke_social_account: IndexerServerSocialAccountsResponse;\n}\n\n/**\n * V2 API Types\n */\n\n/**\n * Individual ticker data from v2 indexer endpoint (server format)\n */\nexport interface IndexerServerV2TickerResponse {\n  product_id: number;\n  ticker_id: string;\n  base_currency: string;\n  quote_currency: string;\n  last_price: number;\n  base_volume: number;\n  quote_volume: number;\n  price_change_percent_24h: number;\n}\n\n/**\n * Response from v2 tickers endpoint (server format)\n * Maps ticker IDs to their respective ticker data\n */\nexport type IndexerServerV2TickersResponse = Record<\n  string,\n  IndexerServerV2TickerResponse\n>;\n\n/**\n * Market hours data from v2 symbols endpoint (server format)\n */\nexport interface IndexerServerV2MarketHours {\n  is_open: boolean;\n  reason: string | null;\n  next_close: string | null;\n  next_open: string | null;\n}\n\n/**\n * Individual symbol data from v2 indexer endpoint (server format)\n */\nexport interface IndexerServerV2Symbol {\n  type: string;\n  product_id: number;\n  symbol: string;\n  price_increment_x18: string;\n  size_increment: string;\n  min_size: string;\n  maker_fee_rate_x18: string;\n  taker_fee_rate_x18: string;\n  long_weight_initial_x18: string;\n  long_weight_maintenance_x18: string;\n  /**\n   * Defined only for perp markets with a max OI cap\n   */\n  max_open_interest_x18: string | null;\n  /**\n   * Defined only for xStocks spot markets\n   */\n  exchange_rate_x18: string | null;\n  trading_status: string;\n  isolated_only: boolean;\n  market_hours: IndexerServerV2MarketHours | null;\n  /**\n   * Boost tier for products with rewards boosts. Null for non-boosted products.\n   * 0 = none, 1 = taker 4x / maker 4x, 2 = taker 3x / maker 4x\n   */\n  boost_type: number | null;\n  /**\n   * Taker rewards multiplier. Null for non-boosted products.\n   */\n  taker_multiplier: number | null;\n  /**\n   * Maker rewards multiplier. Null for non-boosted products.\n   */\n  maker_multiplier: number | null;\n}\n\n/**\n * Response from v2 symbols endpoint (server format)\n * Maps symbols to their respective data\n */\nexport type IndexerServerV2SymbolsResponse = Record<\n  string,\n  IndexerServerV2Symbol\n>;\n\n/**\n * Wire `request_type` the indexer echoes on failure envelopes. The indexer's failure envelope is\n * keyed by route (`<verb>_<query_type>`), mirroring the engine and trigger services. Kept as a\n * `${string}_${string}` template to avoid enumerating the full set of v1 query types declared\n * above.\n */\nexport type IndexerServerRequestType = `${string}_${string}`;\n\n/**\n * Failure envelope returned by the indexer service API. Mirrors the failure shape used by the\n * engine and trigger services: a `status: 'failure'` discriminant plus an `error`/`error_code`\n * pair and the originating `request_type`. A response missing this envelope shape (e.g. a\n * malformed body, or a non-JSON response) is a transport-level error, not a domain error.\n *\n * The v2 REST endpoints do not return this envelope — they use plain HTTP error responses\n * without an `error_code` field.\n */\nexport interface IndexerServerFailureResponse {\n  status: 'failure';\n  error: string;\n  error_code: number;\n  request_type: IndexerServerRequestType;\n}\n\n/**\n * Narrows an unknown response body to the indexer service API failure envelope.\n */\nexport function isIndexerServerFailureResponse(\n  data: unknown,\n): data is IndexerServerFailureResponse {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as Record<string, unknown>).status === 'failure'\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AA+nBA,MAAa,iDAAiD;CAC5D;CACA;CACA;CACA;AACF;;;;AA8NA,SAAgB,+BACd,MACsC;CACtC,OACE,OAAO,SAAS,YAChB,SAAS,QACR,KAAiC,WAAW;AAEjD"}

package/dist/utils/index.d.cts

@@ -1,2 +1,2 @@
-import { n as calcIndexerPerpBalanceValue, r as calcIndexerSpotBalanceValue, t as calcIndexerPerpBalanceNotionalValue } from "../indexerBalanceValue-DqMAvUsj.cjs";
+import { n as calcIndexerPerpBalanceValue, r as calcIndexerSpotBalanceValue, t as calcIndexerPerpBalanceNotionalValue } from "../indexerBalanceValue-yMyf537D.cjs";
 export { calcIndexerPerpBalanceNotionalValue, calcIndexerPerpBalanceValue, calcIndexerSpotBalanceValue };

package/dist/utils/index.d.ts

@@ -1,2 +1,2 @@
-import { n as calcIndexerPerpBalanceValue, r as calcIndexerSpotBalanceValue, t as calcIndexerPerpBalanceNotionalValue } from "../indexerBalanceValue-ZJec8hfI.js";
+import { n as calcIndexerPerpBalanceValue, r as calcIndexerSpotBalanceValue, t as calcIndexerPerpBalanceNotionalValue } from "../indexerBalanceValue-DV3dtvyV.js";
 export { calcIndexerPerpBalanceNotionalValue, calcIndexerPerpBalanceValue, calcIndexerSpotBalanceValue };

package/dist/utils/indexerBalanceValue.d.cts

@@ -1,2 +1,2 @@
-import { n as calcIndexerPerpBalanceValue, r as calcIndexerSpotBalanceValue, t as calcIndexerPerpBalanceNotionalValue } from "../indexerBalanceValue-DqMAvUsj.cjs";
+import { n as calcIndexerPerpBalanceValue, r as calcIndexerSpotBalanceValue, t as calcIndexerPerpBalanceNotionalValue } from "../indexerBalanceValue-yMyf537D.cjs";
 export { calcIndexerPerpBalanceNotionalValue, calcIndexerPerpBalanceValue, calcIndexerSpotBalanceValue };

package/dist/utils/indexerBalanceValue.d.ts

@@ -1,2 +1,2 @@
-import { n as calcIndexerPerpBalanceValue, r as calcIndexerSpotBalanceValue, t as calcIndexerPerpBalanceNotionalValue } from "../indexerBalanceValue-ZJec8hfI.js";
+import { n as calcIndexerPerpBalanceValue, r as calcIndexerSpotBalanceValue, t as calcIndexerPerpBalanceNotionalValue } from "../indexerBalanceValue-DV3dtvyV.js";
 export { calcIndexerPerpBalanceNotionalValue, calcIndexerPerpBalanceValue, calcIndexerSpotBalanceValue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadohq/indexer-client",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "type": "module",
   "sideEffects": false,
   "description": "HTTP client for the Nado indexer — historical data, events, and analytics queries",
@@ -41,8 +41,8 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@nadohq/engine-client": "^0.41.0",
-    "@nadohq/shared": "^0.41.0",
+    "@nadohq/engine-client": "^0.42.0",
+    "@nadohq/shared": "^0.42.0",
     "axios": "1.16.1",
     "ts-mixer": "6.0.4"
   },
@@ -54,5 +54,5 @@
     "bignumber.js": "11.1.1",
     "viem": "2.52.0"
   },
-  "gitHead": "bd534f98c5e429aafc861e1fcc4a639ffd2850a6"
+  "gitHead": "f9db267e3f3a3068f2197faee9b1b827157f33b1"
 }

package/src/IndexerBaseClient.ts

@@ -39,6 +39,7 @@ import {
   mapIndexerOrder,
   mapIndexerPerpPrices,
   mapIndexerPortfolio,
+  mapIndexerPosition,
   mapIndexerProductPayment,
   mapIndexerServerProduct,
   mapIndexerV2Symbols,
@@ -103,6 +104,8 @@ import {
   GetIndexerPointsResponse,
   GetIndexerPortfolioParams,
   GetIndexerPortfolioResponse,
+  GetIndexerPositionsParams,
+  GetIndexerPositionsResponse,
   GetIndexerPrivateAlphaChoiceParams,
   GetIndexerPrivateAlphaChoiceResponse,
   GetIndexerProductSnapshotsParams,
@@ -626,6 +629,53 @@ export class IndexerBaseClient {
     });
   }
 
+  /**
+   * Retrieves a subaccount's historical positions, ordered descending by `openId`.
+   * Positions are tracked for every product except the quote product.
+   *
+   * The response also includes the boundary events (with their transactions) at each
+   * position's open and close, or open and latest update while still open; join them
+   * to positions via `openId` / `closeId` / `submissionIndex`.
+   *
+   * To paginate, pass the last returned position's `openId - 1` as the next request's
+   * `startCursor`.
+   *
+   * @param params
+   */
+  async getPositions(
+    params: GetIndexerPositionsParams,
+  ): Promise<GetIndexerPositionsResponse> {
+    const baseResponse = await this.query('positions', {
+      subaccount: subaccountToHex({
+        subaccountOwner: params.subaccount.subaccountOwner,
+        subaccountName: params.subaccount.subaccountName,
+      }),
+      product_id: params.productId,
+      isolated: params.isolated,
+      open: params.open,
+      idx: params.startCursor,
+      limit: params.limit,
+    });
+
+    // Unlike `getEvents`, boundary events aren't strictly ordered against txs, so join by submission index
+    const txsBySubmissionIdx = new Map(
+      baseResponse.txs.map((tx) => [tx.submission_idx, tx]),
+    );
+
+    return {
+      positions: baseResponse.positions.map(mapIndexerPosition),
+      events: baseResponse.events.map((event) => {
+        const tx = txsBySubmissionIdx.get(event.submission_idx);
+        if (!tx) {
+          throw Error(
+            `No tx found for position boundary event with submission_idx ${event.submission_idx}`,
+          );
+        }
+        return mapIndexerEventWithTx(event, tx);
+      }),
+    };
+  }
+
   /**
    * Retrieves historical funding & interest payments.
    * NOTE: `limit` is an upperbound. If a user changes position size such that his position is 0 during each funding/interest tick,

package/src/dataMappers.ts

@@ -33,6 +33,7 @@ import {
   IndexerPerpBalance,
   IndexerPerpPrices,
   IndexerPortfolioPoint,
+  IndexerPosition,
   IndexerProductPayment,
   IndexerServerBalance,
   IndexerServerCandlestick,
@@ -50,6 +51,7 @@ import {
   IndexerServerPerpPrices,
   IndexerServerPortfolioPoint,
   IndexerServerPortfolioResponse,
+  IndexerServerPosition,
   IndexerServerProduct,
   IndexerServerProductPayment,
   IndexerServerSnapshotsInterval,
@@ -204,6 +206,45 @@ export function mapIndexerMatchEventBalances(
   };
 }
 
+/**
+ * Maps a position returned by the indexer positions query to its client representation.
+ * @param position - The position in server (snake_case, x18 prices) format.
+ * @returns The position with camelCase fields and BigNumber values.
+ */
+export function mapIndexerPosition(
+  position: IndexerServerPosition,
+): IndexerPosition {
+  return {
+    subaccount: position.subaccount,
+    productId: position.product_id,
+    isolated: position.isolated,
+    direction: position.direction,
+    openId: position.open_id,
+    closeId: position.close_id,
+    submissionIndex: position.submission_idx,
+    amount: toBigNumber(position.amount),
+    maxAmount: toBigNumber(position.max_amount),
+    totalOpenAmount: toBigNumber(position.total_open_amount),
+    totalCloseAmount: toBigNumber(position.total_close_amount),
+    averageEntryPrice: removeDecimals(position.average_entry_price),
+    averageExitPrice: removeDecimals(position.average_exit_price),
+    liquidatedAmount: toBigNumber(position.liquidated_amount),
+    maxIsolatedLeverage: removeDecimals(position.max_isolated_leverage_x18),
+    openFee: toBigNumber(position.open_fee),
+    closeFee: toBigNumber(position.close_fee),
+    realizedPnl: toBigNumber(position.realized_pnl),
+    openTimestamp: toBigNumber(position.open_timestamp),
+    updateTimestamp: toBigNumber(position.update_timestamp),
+    openReason: position.open_reason,
+    closeReason: position.close_reason,
+    netFundingPayment: toBigNumber(position.net_funding_payment),
+    netInterestPayment: toBigNumber(position.net_interest_payment),
+    openDigest: position.open_digest,
+    closeDigest: position.close_digest,
+    netEntryUnrealized: toBigNumber(position.net_entry_unrealized),
+  };
+}
+
 export function mapIndexerProductPayment(
   payment: IndexerServerProductPayment,
 ): IndexerProductPayment {

package/src/types/IndexerEventType.ts

@@ -1,11 +1,19 @@
-export type IndexerEventType =
-  | 'liquidate_subaccount'
-  | 'deposit_collateral'
-  | 'withdraw_collateral'
-  | 'withdraw_collateral_v2'
-  | 'settle_pnl'
-  | 'match_orders'
-  | 'transfer_quote'
-  | 'mint_nlp'
-  | 'burn_nlp'
-  | 'claim_builder_fee';
+/**
+ * All balance-change event types emitted by the indexer. This is also the set of
+ * transaction types that can open/close a position (`openReason` / `closeReason`).
+ */
+export const INDEXER_EVENT_TYPES = [
+  'liquidate_subaccount',
+  'deposit_collateral',
+  'withdraw_collateral',
+  'withdraw_collateral_v2',
+  'settle_pnl',
+  'match_orders',
+  'transfer_quote',
+  'mint_nlp',
+  'burn_nlp',
+  'claim_builder_fee',
+  'delist_product',
+] as const;
+
+export type IndexerEventType = (typeof INDEXER_EVENT_TYPES)[number];

package/src/types/NadoTx.ts

@@ -4,12 +4,6 @@ export interface NadoMatchOrdersTx {
   };
 }
 
-export interface NadoMatchOrdersRfqTx {
-  match_orders_r_f_q: {
-    product_id: number;
-  };
-}
-
 export interface NadoLiquidateSubaccountTx {
   liquidate_subaccount: {
     sender: string;
@@ -63,7 +57,6 @@ export interface NadoTransferQuoteTx {
 
 export type NadoTx =
   | NadoMatchOrdersTx
-  | NadoMatchOrdersRfqTx
   | NadoLiquidateSubaccountTx
   | NadoDepositCollateralTx
   | NadoTransferQuoteTx

package/src/types/clientTypes.ts

@@ -561,6 +561,112 @@ export interface IndexerMatchEvent extends Subaccount {
 
 export type GetIndexerMatchEventsResponse = IndexerMatchEvent[];
 
+/**
+ * Position history
+ */
+
+/**
+ * Params for querying a subaccount's historical positions. All parameters except
+ * `subaccount` are optional filters.
+ */
+export interface GetIndexerPositionsParams {
+  /**
+   * Subaccount to query. Isolated positions are also returned under the parent
+   * subaccount, so always query with the parent.
+   */
+  subaccount: Subaccount;
+  /** When provided, only return positions of the specified product. */
+  productId?: number;
+  /** `true`: only isolated positions, `false`: only cross positions. Omit for both. */
+  isolated?: boolean;
+  /** `true`: only positions that are still open, `false`: only closed positions. Omit for both. */
+  open?: boolean;
+  /**
+   * Max `openId`, inclusive. To paginate, pass the last returned position's
+   * `openId - 1` as the next request's `startCursor`.
+   */
+  startCursor?: string;
+  /** Max number of positions to return. Defaults to 100, max 500. */
+  limit?: number;
+}
+
+/**
+ * A historical position for a subaccount in a product. A position opens when the balance
+ * goes from zero to non-zero or flips direction, and closes when the balance returns to
+ * zero or flips again. All amount fields are absolute values; the side of the position is
+ * given by `direction`.
+ */
+export interface IndexerPosition {
+  /** Subaccount hex ID associated with the position. */
+  subaccount: string;
+  productId: number;
+  isolated: boolean;
+  /** Direction of the position. `true` for long, `false` for short. */
+  direction: boolean;
+  /** `submissionIndex` of the transaction that opened the position. */
+  openId: string;
+  /** `submissionIndex` of the transaction that closed the position; `-1` if still open. */
+  closeId: string;
+  /** `submissionIndex` of the last transaction that updated the position. */
+  submissionIndex: string;
+  /** Current size of the position; `0` once the position is closed. */
+  amount: BigNumber;
+  /** Peak size reached by the position. */
+  maxAmount: BigNumber;
+  /** Total amount opened on this position. */
+  totalOpenAmount: BigNumber;
+  /** Total amount closed on this position. */
+  totalCloseAmount: BigNumber;
+  /** Volume-weighted average entry price of the position. */
+  averageEntryPrice: BigNumber;
+  /** Volume-weighted average exit price of the position. */
+  averageExitPrice: BigNumber;
+  /** Total amount closed by liquidations on this position. */
+  liquidatedAmount: BigNumber;
+  /**
+   * Peak leverage reached by the isolated position; `0` for cross positions.
+   * Set to `i128::MAX` (decimal adjusted) when the position's equity is below zero.
+   */
+  maxIsolatedLeverage: BigNumber;
+  /** Total fees paid on fills that increased the position. */
+  openFee: BigNumber;
+  /** Total fees paid on fills that decreased the position. */
+  closeFee: BigNumber;
+  /** Realized PnL for this position. */
+  realizedPnl: BigNumber;
+  /** Unix epoch in seconds of when the position was opened. */
+  openTimestamp: BigNumber;
+  /** Unix epoch in seconds of when the position was last updated. */
+  updateTimestamp: BigNumber;
+  /** The transaction type that opened the position, e.g. `match_orders`. */
+  openReason: IndexerEventType;
+  /** The transaction type that closed the position; `null` if still open. */
+  closeReason: IndexerEventType | null;
+  /** Net funding payment on this position. Only for perp positions. */
+  netFundingPayment: BigNumber;
+  /** Net interest payment on this position. Only for spot positions. */
+  netInterestPayment: BigNumber;
+  /** Digest of the order that opened the position; `null` if not opened by a match. */
+  openDigest: string | null;
+  /** Digest of the order that closed the position; `null` if not closed by a match or still open. */
+  closeDigest: string | null;
+  netEntryUnrealized: BigNumber;
+}
+
+/**
+ * Response for the positions query.
+ */
+export interface GetIndexerPositionsResponse {
+  /** Positions in descending order by `openId`. */
+  positions: IndexerPosition[];
+  /**
+   * Events (with their transactions) at each position's boundaries: open and close, or
+   * open and latest update while still open. Join them to positions via
+   * `openId` / `closeId` / `submissionIndex`.
+   */
+  events: IndexerEventWithTx[];
+}
+
 /**
  * Quote price
  */

package/src/types/serverModelTypes.ts

@@ -170,6 +170,65 @@ export interface IndexerServerMatchEventBalances {
   quote?: IndexerServerBalance;
 }
 
+/**
+ * Positions
+ */
+
+/**
+ * A single historical position. All amount fields are absolute values; the side of the
+ * position is given by `direction`.
+ */
+export interface IndexerServerPosition {
+  subaccount: string;
+  product_id: number;
+  isolated: boolean;
+  // true for long, false for short
+  direction: boolean;
+  // submission_idx of the transaction that opened the position
+  open_id: string;
+  // submission_idx of the transaction that closed the position; -1 if still open
+  close_id: string;
+  // submission_idx of the last transaction that updated the position
+  submission_idx: string;
+  // Current size of the position; 0 once the position is closed
+  amount: string;
+  // Peak size reached by the position
+  max_amount: string;
+  total_open_amount: string;
+  total_close_amount: string;
+  // Volume-weighted average entry price (x18)
+  average_entry_price: string;
+  // Volume-weighted average exit price (x18)
+  average_exit_price: string;
+  // Total amount closed by liquidations on this position
+  liquidated_amount: string;
+  // Peak leverage reached by the isolated position; 0 for cross positions.
+  // Set to i128::MAX when the position's equity is below zero
+  max_isolated_leverage_x18: string;
+  // Total fees paid on fills that increased the position
+  open_fee: string;
+  // Total fees paid on fills that decreased the position
+  close_fee: string;
+  realized_pnl: string;
+  // Unix epoch in seconds of when the position was opened
+  open_timestamp: string;
+  // Unix epoch in seconds of when the position was last updated
+  update_timestamp: string;
+  // The transaction type that opened the position, e.g. `match_orders`
+  open_reason: IndexerEventType;
+  // The transaction type that closed the position; null if still open
+  close_reason: IndexerEventType | null;
+  // Net funding payment on this position. Only for perp positions
+  net_funding_payment: string;
+  // Net interest payment on this position. Only for spot positions
+  net_interest_payment: string;
+  // Digest of the order that opened the position; null if not opened by a match
+  open_digest: string | null;
+  // Digest of the order that closed the position; null if not closed by a match or still open
+  close_digest: string | null;
+  net_entry_unrealized: string;
+}
+
 /**
  * Oracle price
  */

package/src/types/serverTypes.ts

@@ -19,6 +19,7 @@ import {
   IndexerServerNlpSnapshot,
   IndexerServerOraclePrice,
   IndexerServerOrder,
+  IndexerServerPosition,
   IndexerServerProductPayment,
   IndexerServerProductSnapshot,
   IndexerServerSnapshotsInterval,
@@ -155,6 +156,24 @@ export interface IndexerServerMatchEventsParams {
   idx?: string;
 }
 
+/**
+ * Params for the positions query. All parameters except `subaccount` are optional filters.
+ */
+export interface IndexerServerPositionsParams {
+  // Subaccount hex identifier. Isolated positions are also returned under the parent subaccount
+  subaccount: string;
+  // When provided, only return positions of the specified product
+  product_id?: number;
+  // If not given, will return both isolated & cross positions
+  isolated?: boolean;
+  // If not given, will return both open & closed positions
+  open?: boolean;
+  // open_id for pagination, inclusive (only positions with open_id <= idx are returned)
+  idx?: number | string;
+  // Max number of positions to return. Defaults to 100, max 500
+  limit?: number;
+}
+
 export interface IndexerServerLinkedSignerParams {
   subaccount: string;
 }
@@ -281,6 +300,7 @@ export interface IndexerServerQueryRequestByType {
   orders: IndexerServerOrdersParams;
   perp_prices: IndexerServerPerpPricesParams;
   portfolio: IndexerServerPortfolioParams;
+  positions: IndexerServerPositionsParams;
   price: IndexerServerPriceParams;
   product_snapshots: IndexerServerMultiProductsParams;
   products: IndexerServerProductsParams;
@@ -432,6 +452,18 @@ export interface IndexerServerMatchEventsResponse {
   txs: IndexerServerTx[];
 }
 
+/**
+ * Response for the positions query. Positions are in descending order by `open_id`.
+ * `events` / `txs` are the events and transactions at each position's boundaries
+ * (open and close, or open and latest update while still open), joined to positions
+ * via `open_id` / `close_id` / `submission_idx`.
+ */
+export interface IndexerServerPositionsResponse {
+  positions: IndexerServerPosition[];
+  events: IndexerServerEvent[];
+  txs: IndexerServerTx[];
+}
+
 export interface IndexerServerQuotePriceResponse {
   price_x18: string;
 }
@@ -702,6 +734,7 @@ export interface IndexerServerQueryResponseByType {
   orders: IndexerServerOrdersResponse;
   perp_prices: IndexerServerPerpPricesResponse;
   portfolio: IndexerServerPortfolioResponse;
+  positions: IndexerServerPositionsResponse;
   price: IndexerServerPriceResponse;
   product_snapshots: IndexerServerMultiProductsResponse;
   products: IndexerServerProductsResponse;