getQuoteEventsByType

Decoded subgraph events for one quote, filtered to specific event types — useful for building per-quote timelines that pull out just funding ticks or settle-uPnL events. Paged.


import { getQuoteEventsByType, QuoteEventType } from "@symmio/trading-core";
 
const { rows, hasMore } = await getQuoteEventsByType(config, {
  quoteId: 42n,
  types: [QuoteEventType.ChargeFundingRate],
  first: 20,
});

Parameters

quoteIdbigintrequired

On-chain quote id to read events for.

typesreadonly QuoteEventType[]required

Event types to include: SettleUpnl (SETTLE_UPNL), ChargeFundingRate (CHARGE_FUNDING_RATE), ChargeAccumulatedFundingFee (CHARGE_ACCUMULATED_FUNDING_FEE).

firstnumberdefault 50

Page size.

skipnumberdefault 0

Page offset.

orderDirection"asc" | "desc"default desc

Sort direction on the event timestamp (newest first).

chainIdnumberoptional

Optional chain override.

Returns

GetQuoteEventsByTypeReturnType

rowsQuoteEventRow[]

The decoded event rows for the requested types.

hasMoreboolean

true when the page came back full (rows.length === first) — fetch the next page by advancing skip.

Query options


import { getQuoteEventsByTypeQueryOptions, QuoteEventType } from "@symmio/trading-core";
import { useQuery } from "@tanstack/react-query";
 
useQuery(
  getQuoteEventsByTypeQueryOptions(config, {
    quoteId: 42n,
    types: [QuoteEventType.ChargeFundingRate],
  }),
);