@zofai/zo-sdk 0.1.92

package/src/implementations/USDZDataAPI.ts

@@ -0,0 +1,1548 @@
+/* eslint-disable no-await-in-loop */
+/**
+ * USDZ DataAPI implementation
+ * Implements USDZ-specific data access methods
+ */
+
+import type { DynamicFieldInfo, SuiClient } from '@mysten/sui/client'
+import type { Transaction } from '@mysten/sui/transactions'
+import { SUI_CLOCK_OBJECT_ID } from '@mysten/sui/utils'
+
+import { BaseDataAPI } from '../abstract'
+import type { Network } from '../consts'
+import { LPToken, SECONDS_PER_EIGHT_HOUR, USDZ_TOKEN_DECIMALS } from '../consts'
+import type {
+  IBaseHistoryResponse,
+  IBaseOrderType,
+  IBaseStaked,
+  IUSDZCredential,
+  IUSDZDataAPI,
+  IUSDZFundingFeeModel,
+  IUSDZMarketInfo,
+  IUSDZMarketValuationInfo,
+  IUSDZOiFundingModel,
+  IUSDZOiFundingState,
+  IUSDZOrderCapInfo,
+  IUSDZOrderInfo,
+  IUSDZPositionCapInfo,
+  IUSDZPositionConfig,
+  IUSDZPositionInfo,
+  IUSDZPriceImpactConfig,
+  IUSDZRebaseFeeModel,
+  IUSDZReservingFeeModel,
+  IUSDZStakePool,
+  IUSDZSymbolConfig,
+  IUSDZSymbolInfo,
+  IUSDZVaultInfo,
+} from '../interfaces'
+import { joinSymbol, parseSymbolKey, parseValue, suiSymbolToSymbol } from '../utils'
+
+export class USDZDataAPI extends BaseDataAPI implements IUSDZDataAPI {
+  constructor(
+    network: Network,
+    provider: SuiClient,
+    apiEndpoint: string,
+    connectionURL: string,
+  ) {
+    super(network, provider, apiEndpoint, connectionURL, LPToken.USDZ)
+  }
+
+  public async getStaked(owner: string): Promise<IBaseStaked> {
+    let rawCredentialsData: any[] = []
+    let queryNextPage = true
+    let queryCursor: string | undefined | null
+
+    const limit = 50
+
+    while (queryNextPage) {
+      const { data, hasNextPage, nextCursor } = await this.provider.getOwnedObjects({
+        owner,
+        filter: {
+          MoveModule: {
+            package: this.sharedConfig.zoStaking.package,
+            module: 'pool',
+          },
+        },
+        options: {
+          showType: true,
+          showContent: true,
+        },
+        cursor: queryCursor,
+        limit,
+      })
+
+      queryNextPage = hasNextPage
+      queryCursor = nextCursor!
+      if (!data)
+        break
+      rawCredentialsData = [...rawCredentialsData, ...data]
+    }
+
+    const pool = await this.getStakePool()
+
+    const credentials = rawCredentialsData
+      .filter(
+        (item: any) =>
+          item.data.type
+          === `${this.sharedConfig.zoStaking.package}::pool::Credential<${this.consts.zoCore.package}::usdz::USDZ, 0x2::sui::SUI>`,
+      )
+      .map((item: any) =>
+        USDZDataAPI.parseCredential(item, pool),
+      )
+    return {
+      credentials,
+      amount: credentials.reduce(
+        (acc: bigint, cur: IUSDZCredential) => acc + cur.amount,
+        BigInt(0),
+      ),
+      claimable: credentials.reduce(
+        (acc: bigint, cur: IUSDZCredential) => acc + cur.claimable,
+        BigInt(0),
+      ),
+    }
+  }
+
+  public async getStakePool(): Promise<IUSDZStakePool> {
+    const poolId = this.sharedConfig.zoStaking.pools.usdz
+    const raw = await this.provider.getObject({
+      id: poolId,
+      options: {
+        showContent: true,
+      },
+    })
+    return USDZDataAPI.parseStakePool(raw)
+  }
+
+  /**
+   * Creates vaults valuation for USDZ
+   */
+  public valuateVaults(tx: Transaction) {
+    const vaultsValuation = tx.moveCall({
+      target: `${this.consts.zoCore.upgradedPackage}::market::create_vaults_valuation`,
+      typeArguments: [`${this.consts.zoCore.package}::usdz::USDZ`],
+      arguments: [
+        tx.object(SUI_CLOCK_OBJECT_ID),
+        tx.object(this.consts.zoCore.market),
+      ],
+    })
+
+    for (const key of Object.keys(this.consts.zoCore.vaults)) {
+      const vault = this.consts.zoCore.vaults[key]
+      tx.moveCall({
+        target: `${this.consts.zoCore.upgradedPackage}::market::valuate_vault`,
+        typeArguments: [
+          `${this.consts.zoCore.package}::usdz::USDZ`,
+          this.consts.coins[key].module,
+        ],
+        arguments: [
+          tx.object(this.consts.zoCore.market),
+          tx.object(vault.reservingFeeModel),
+          tx.object(this.consts.pythFeeder.feeder[key]),
+          vaultsValuation,
+        ],
+      })
+    }
+    return vaultsValuation
+  }
+
+  /**
+   * Creates symbols valuation for USDZ
+   */
+  public valuateSymbols(tx: Transaction) {
+    const symbolsValuation = tx.moveCall({
+      target: `${this.consts.zoCore.upgradedPackage}::market::create_symbols_valuation`,
+      typeArguments: [`${this.consts.zoCore.package}::usdz::USDZ`],
+      arguments: [
+        tx.object(SUI_CLOCK_OBJECT_ID),
+        tx.object(this.consts.zoCore.market),
+      ],
+    })
+
+    for (const key of Object.keys(this.consts.zoCore.symbols)) {
+      const [direction, token] = parseSymbolKey(key)
+      const symbol = this.consts.zoCore.symbols[key]
+      tx.moveCall({
+        target: `${this.consts.zoCore.upgradedPackage}::market::valuate_symbol`,
+        typeArguments: [
+          `${this.consts.zoCore.package}::usdz::USDZ`,
+          this.consts.coins[token].module,
+          `${this.consts.zoCore.package}::market::${direction.toUpperCase()}`,
+        ],
+        arguments: [
+          tx.object(this.consts.zoCore.market),
+          tx.object(symbol.fundingFeeModel),
+          tx.object(this.consts.pythFeeder.feeder[token]),
+          symbolsValuation,
+        ],
+      })
+    }
+    return symbolsValuation
+  }
+
+  /**
+   * Creates both vaults and symbols valuation
+   */
+  public valuate(tx: Transaction) {
+    const vaultsValuation = this.valuateVaults(tx)
+    const symbolsValuation = this.valuateSymbols(tx)
+    return { vaultsValuation, symbolsValuation }
+  }
+
+  /**
+   * Valuates the USDZ market
+   */
+  public async valuateMarket(): Promise<IUSDZMarketValuationInfo> {
+    const marketInfo = await this.getMarketInfo()
+    let usdzPrice = 0
+    let value = 0
+
+    const vaultPromises = Object.keys(this.consts.zoCore.vaults).map(async (vault) => {
+      const vaultInfo = await this.getVaultInfo(vault)
+      const reservingFeeDelta = USDZDataAPI.calculateVaultReservingFee(vaultInfo, vaultInfo.reservingFeeModel, Date.now() / 1000)
+      return (reservingFeeDelta + vaultInfo.liquidity + vaultInfo.reservedAmount) * (await this.getOraclePrice(vault)).getPriceUnchecked().getPriceAsNumberUnchecked() / (10 ** this.consts.coins[vault].decimals)
+    })
+
+    const symbolPromises = Object.keys(this.consts.zoCore.symbols).map(async (symbol) => {
+      const [direction, tokenId] = parseSymbolKey(symbol)
+      const symbolInfo = await this.getSymbolInfo(tokenId, direction === 'long')
+      const deltaSize = USDZDataAPI.calcDeltaSize(
+        symbolInfo,
+        (await this.getOraclePrice(tokenId)).getPriceUnchecked().getPriceAsNumberUnchecked(),
+      )
+
+      // OI context for funding fee delta
+      const oiState = await this.getSymbolOiFundingState(tokenId)
+      const pairedSymbol = await this.getSymbolInfo(tokenId, !(direction === 'long'))
+
+      const fundingFeeDelta = USDZDataAPI.calculateSymbolFundingFee(
+        symbolInfo,
+        symbolInfo.fundingFeeModel,
+        (await this.getOraclePrice(tokenId)).getPriceUnchecked().getPriceAsNumberUnchecked(),
+        marketInfo.lpSupplyWithDecimals,
+        Date.now() / 1000,
+        oiState && oiState.enabled ? oiState.model : undefined,
+        pairedSymbol.openingSize,
+      )
+
+      return fundingFeeDelta + deltaSize
+    })
+
+    const [vaultValues, symbolValues] = await Promise.all([Promise.all(vaultPromises), Promise.all(symbolPromises)])
+
+    value = vaultValues.reduce((acc: number, curr: number) => acc + curr, 0)
+    value += symbolValues.reduce((acc: number, curr: number) => acc + curr, 0)
+
+    usdzPrice = value / marketInfo.lpSupplyWithDecimals
+
+    return {
+      marketCap: value,
+      price: usdzPrice,
+      supply: marketInfo.lpSupplyWithDecimals,
+      apr: Number(marketInfo.apr),
+    }
+  }
+
+  /**
+   * Gets USDZ market information
+   */
+  public async getMarketInfo(): Promise<IUSDZMarketInfo> {
+    this.validateCache()
+    if (this.marketInfoCache) {
+      return this.marketInfoCache
+    }
+    const rawData = await this.provider.getObject({
+      id: this.consts.zoCore.market,
+      options: {
+        showContent: true,
+      },
+    })
+    return USDZDataAPI.parseMarketInfo(rawData)
+  }
+
+  /**
+   * Gets USDZ vault information
+   */
+  public async getVaultInfo(vaultToken: string): Promise<IUSDZVaultInfo> {
+    this.validateCache()
+    if (this.vaultInfoCache[vaultToken]) {
+      return this.vaultInfoCache[vaultToken]
+    }
+
+    const rawData = await this.provider.getDynamicFieldObject({
+      parentId: this.consts.zoCore.vaultsParent,
+      name: {
+        type: `${this.consts.zoCore.package}::market::VaultName<${this.consts.coins[vaultToken].module}>`,
+        value: { dummy_field: false },
+      },
+    })
+    return await this.parseVaultInfo(rawData)
+  }
+
+  /**
+   * Gets USDZ symbol information
+   */
+  public async getSymbolInfo(indexToken: string, long: boolean): Promise<IUSDZSymbolInfo> {
+    this.validateCache()
+    const symbol = joinSymbol(long ? 'long' : 'short', indexToken)
+    if (this.symbolInfoCache[symbol]) {
+      return this.symbolInfoCache[symbol]
+    }
+    const rawData = await this.provider.getDynamicFieldObject({
+      parentId: this.consts.zoCore.symbolsParent,
+      name: {
+        type: `${this.consts.zoCore.package}::market::SymbolName<${this.consts.coins[indexToken].module}, ${this.consts.zoCore.package}::market::${long ? 'LONG' : 'SHORT'}>`,
+        value: { dummy_field: false },
+      },
+    })
+    return await this.parseSymbolInfo(rawData, long)
+  }
+
+  public async getPositionConfig(indexToken: string, long: boolean): Promise<IUSDZPositionConfig> {
+    this.validateCache()
+    const symbol = joinSymbol(long ? 'long' : 'short', indexToken)
+    if (this.positionConfigCache[symbol]) {
+      return this.positionConfigCache[symbol]
+    }
+    const rawData = await this.provider.getObject({
+      id: this.consts.zoCore.symbols[symbol].positionConfig,
+      options: {
+        showContent: true,
+      },
+    })
+    return USDZDataAPI.parsePositionConfig(rawData)
+  }
+
+  /**
+   * Gets USDZ symbol configuration
+   */
+  public async getSymbolConfig(indexToken: string, long: boolean): Promise<IUSDZSymbolConfig | null> {
+    this.validateCache()
+    try {
+      const rawData = await this.provider.getDynamicFieldObject({
+        parentId: this.consts.zoCore.market,
+        name: {
+          type: `${this.consts.zoCore.package}::market::SymbolName<${this.consts.coins[indexToken].module}, ${this.consts.zoCore.package}::market::${long ? 'LONG' : 'SHORT'}>`,
+          value: { dummy_field: false },
+        },
+      })
+      return USDZDataAPI.parseSymbolConfig(rawData)
+    }
+    catch {
+      // If the dynamic field doesn't exist, return null
+      console.error('Symbol Config Not Found')
+      return null
+    }
+  }
+
+  /**
+   * Gets USDZ symbol OI funding state (global per symbol)
+   */
+  public async getSymbolOiFundingState(indexToken: string): Promise<IUSDZOiFundingState | null> {
+    this.validateCache()
+    try {
+      const rawData = await this.provider.getDynamicFieldObject({
+        parentId: this.consts.zoCore.market,
+        name: {
+          type: `0x562c9969f4c4046b33437c80c1fcdb389e8113d43de5b97c29a10b52db8f3287::funding::FundingStateKey<${this.consts.coins[indexToken].module}>`,
+          value: { dummy_field: false },
+        },
+      })
+      return USDZDataAPI.parseOiFundingState(rawData)
+    }
+    catch (e: any) {
+      console.error('Error Fetching USDZ Symbol OI Funding State:', e)
+      return null
+    }
+  }
+
+  /**
+   * Gets price impact configuration for a symbol.
+   * Price impact config applies to both long and short directions for the same index token.
+   */
+  public async getPriceImpactConfig(indexToken: string): Promise<IUSDZPriceImpactConfig | null> {
+    this.validateCache()
+    try {
+      const rawData = await this.provider.getDynamicFieldObject({
+        parentId: this.consts.zoCore.market,
+        name: {
+          type: `0x28405237f444c214c03ba32778a2e1716c3311bbe517b9f216b0d83778c36729::price_impact::PriceImpactConfigKey<${this.consts.coins[indexToken].module}>`,
+          value: { dummy_field: false },
+        },
+      })
+      return USDZDataAPI.parsePriceImpactConfig(rawData)
+    }
+    catch (e: any) {
+      // If the dynamic field doesn't exist, return null (price impact not configured for this symbol)
+      console.error('Error Fetching Price Impact Config:', e)
+      return null
+    }
+  }
+
+  public async getPositionCapInfoList(owner: string): Promise<IUSDZPositionCapInfo[]> {
+    const positionCapInfoList: IUSDZPositionCapInfo[] = []
+    let cursor: string | undefined | null
+    let hasNextPage = true
+
+    while (hasNextPage) {
+      const positionCaps = await this.provider.getOwnedObjects({
+        owner,
+        filter: {
+          MoveModule: {
+            package: this.consts.zoCore.package,
+            module: 'market',
+          },
+        },
+        options: {
+          showType: true,
+        },
+        cursor,
+      })
+
+      for (const positionCap of positionCaps.data) {
+        if (positionCap.data?.type?.includes('PositionCap')) {
+          positionCapInfoList.push({
+            positionCapId: positionCap.data.objectId,
+            symbol0: positionCap.data.type.split('<')[1].split(',')[0].trim(),
+            symbol1: positionCap.data.type.split('<')[1].split(',')[1].split(',')[0].trim(),
+            long: positionCap.data.type.includes('LONG'),
+          })
+        }
+      }
+
+      // If we don't want to fetch all pages or there are no more pages, break the loop
+      hasNextPage = positionCaps.hasNextPage
+      cursor = positionCaps.nextCursor
+    }
+
+    return positionCapInfoList
+  }
+
+  public async getPositionInfoList(positionCapInfoList: IUSDZPositionCapInfo[], owner: string, batchSize = 10) {
+    const positionInfoList: IUSDZPositionInfo[] = []
+
+    // Process in batches of 10
+    for (let i = 0; i < positionCapInfoList.length; i += batchSize) {
+      const batch = positionCapInfoList.slice(i, i + batchSize)
+
+      await Promise.all(batch.map(async (positionCapInfo) => {
+        try {
+          const positionRaw = await this.provider.getDynamicFieldObject({
+            parentId: this.consts.zoCore.positionsParent,
+            name: {
+              type: `${this.consts.zoCore.package}::market::PositionName<${positionCapInfo.symbol0}, ${positionCapInfo.symbol1}, ${this.consts.zoCore.package}::market::${positionCapInfo.long ? 'LONG' : 'SHORT'}>`,
+              value: {
+                owner,
+                id: positionCapInfo.positionCapId,
+              },
+            },
+          })
+          positionInfoList.push(await this.parsePositionInfo(positionRaw, positionCapInfo.positionCapId))
+        }
+        catch (error) {
+          // Position might have been deleted after force settlement
+          console.warn(`Failed to parse position info for position cap ID ${positionCapInfo.positionCapId}: ${error}`)
+          // Continue with next position without adding this one to the list
+        }
+      }))
+    }
+
+    return positionInfoList.sort((a, b) => a.openTimestamp > b.openTimestamp ? 1 : -1)
+  }
+
+  public async getOpenPositions(): Promise<IUSDZPositionInfo[]> {
+    let positionDynamicFields: DynamicFieldInfo[] = []
+    let _continue = true
+    let cursor
+    while (_continue) {
+      // data here will be a list of dynamic fields containing name and value
+      const { data, nextCursor, hasNextPage }
+        = await this.provider.getDynamicFields({
+          parentId: this.consts.zoCore.positionsParent,
+          cursor,
+        })
+
+      positionDynamicFields = positionDynamicFields.concat(data)
+      _continue = hasNextPage
+      cursor = nextCursor
+    }
+
+    // then we query by dynamic field names and order by time
+    const positionInfoList: IUSDZPositionInfo[] = []
+    await Promise.all(
+      positionDynamicFields.map(async (positionDynamicField) => {
+        const positionRaw = await this.provider.getDynamicFieldObject({
+          parentId: this.consts.zoCore.positionsParent,
+          name: positionDynamicField.name,
+        })
+
+        if (positionRaw?.data?.content) {
+          const positionInfo = await this.parsePositionInfo(
+            positionRaw,
+            positionDynamicField.objectId,
+          )
+          if (positionInfo) {
+            positionInfoList.push(positionInfo)
+          }
+        }
+      }),
+    )
+
+    return positionInfoList
+      .filter(positionInfo => !positionInfo.closed)
+      .sort((a, b) => (a.openTimestamp > b.openTimestamp ? 1 : -1))
+  }
+
+  public async getOrderCapInfoList(owner: string): Promise<IUSDZOrderCapInfo[]> {
+    const orderCapInfoList: IUSDZOrderCapInfo[] = []
+    let cursor: string | undefined | null
+    let hasNextPage = true
+
+    while (hasNextPage) {
+      const orderCaps = await this.provider.getOwnedObjects({
+        owner,
+        filter: {
+          MoveModule: {
+            package: this.consts.zoCore.package,
+            module: 'market',
+          },
+        },
+        options: {
+          showType: true,
+          showContent: true,
+        },
+        cursor,
+      })
+
+      for (const orderCap of orderCaps.data) {
+        if (orderCap.data?.type?.includes('OrderCap')) {
+          orderCapInfoList.push({
+            orderCapId: orderCap.data.objectId,
+            symbol0: orderCap.data.type.split('<')[1].split(',')[0].trim(),
+            symbol1: orderCap.data.type.split('<')[1].split(',')[1].split(',')[0].trim(),
+            long: orderCap.data.type.includes('LONG'),
+            positionId: (orderCap.data.content as any)?.fields?.position_id,
+          })
+        }
+      }
+
+      hasNextPage = orderCaps.hasNextPage
+      cursor = orderCaps.nextCursor
+    }
+
+    return orderCapInfoList
+  }
+
+  public async getOrderInfoList(orderCapInfoList: IUSDZOrderCapInfo[], owner: string, batchSize = 10) {
+    const orderInfoList: IUSDZOrderInfo[] = []
+
+    // Process in batches of 10
+    for (let i = 0; i < orderCapInfoList.length; i += batchSize) {
+      const batch = orderCapInfoList.slice(i, i + batchSize)
+
+      await Promise.all(batch.map(async (orderCapInfo) => {
+        try {
+          const orderRaw = await this.provider.getDynamicFieldObject({
+            parentId: this.consts.zoCore.ordersParent,
+            name: {
+              // We have enforced collateral coin type to match with fee coin type so we can use symbol0 in the first slot and the last slot of the OrderName
+              type: `${this.consts.zoCore.package}::market::OrderName<${orderCapInfo.symbol0}, ${orderCapInfo.symbol1}, ${this.consts.zoCore.package}::market::${orderCapInfo.long ? 'LONG' : 'SHORT'}, ${orderCapInfo.symbol0}>`,
+              value: {
+                owner,
+                id: orderCapInfo.orderCapId,
+                position_id: {
+                  vec: orderCapInfo.positionId ? [orderCapInfo.positionId] : [],
+                },
+              },
+            },
+          })
+          orderInfoList.push(this.parseOrderInfo(orderRaw, orderCapInfo.orderCapId))
+        }
+        catch (error) {
+          // Order might have been deleted
+          console.warn(`Failed to parse order info for order cap ID ${orderCapInfo.orderCapId}: ${error}`)
+          // Continue with next order without adding this one to the list
+        }
+      }))
+    }
+
+    return orderInfoList.sort((a, b) => a.createdAt > b.createdAt ? 1 : -1)
+  }
+
+  public async hasReferral(referree: string): Promise<boolean> {
+    const raw = await this.getReferralData(referree)
+    return !raw.error
+  }
+
+  public async getReferralData(referree: string): Promise<any> {
+    const raw = await this.provider.getDynamicFieldObject({
+      parentId: this.consts.zoCore.referralsParent,
+      name: {
+        type: 'address',
+        value: referree,
+      },
+    })
+    return raw
+  }
+
+  /**
+   * Gets rebase fee model for USDZ
+   */
+  public async getRebaseFeeModel(): Promise<{ base: number, multiplier: number }> {
+    this.validateCache()
+    if (this.rebaseFeeModelCache) {
+      return this.rebaseFeeModelCache
+    }
+    const rawData = await this.provider.getObject({
+      id: this.consts.zoCore.rebaseFeeModel,
+      options: {
+        showContent: true,
+      },
+    })
+    return USDZDataAPI.parseRebaseFeeModel(rawData)
+  }
+
+  public async fundingFeeRate(indexToken: string, long: boolean): Promise<number> {
+    const oiState = await this.getSymbolOiFundingState(indexToken)
+
+    if (!oiState || !oiState.enabled) {
+      const symbol = await this.getSymbolInfo(indexToken, long)
+      if (symbol.lastUpdate <= 0) {
+        return 0
+      }
+      const price = (await this.getOraclePrice(indexToken)).getPriceUnchecked().getPriceAsNumberUnchecked()
+      const lpSupplyAmount = (await this.getMarketInfo()).lpSupplyWithDecimals
+      const model = symbol.fundingFeeModel
+      const elapsed = SECONDS_PER_EIGHT_HOUR
+
+      const deltaSize = USDZDataAPI.calcDeltaSize(symbol, price)
+      const pnlPerLp = (symbol.realisedPnl + symbol.unrealisedFundingFeeValue + deltaSize) / lpSupplyAmount
+      return USDZDataAPI.calcFundingFeeRate(model, pnlPerLp, elapsed)
+    }
+
+    // OI model enabled: rate based on long/short imbalance
+    const longSymbol = await this.getSymbolInfo(indexToken, true)
+    const shortSymbol = await this.getSymbolInfo(indexToken, false)
+
+    if (longSymbol.lastUpdate <= 0 && shortSymbol.lastUpdate <= 0) {
+      return 0
+    }
+
+    const elapsed = SECONDS_PER_EIGHT_HOUR
+    const longSize = longSymbol.openingSize
+    const shortSize = shortSymbol.openingSize
+
+    const deltaRate = USDZDataAPI.calcOiFundingFeeRate(oiState.model, longSize, shortSize, elapsed)
+    return long ? deltaRate : -deltaRate
+  }
+
+  public async rebaseFeeRate(collateralToken: string, increase: boolean, amount: number): Promise<number> {
+    let vaultValue = 0
+    if (!increase && amount > 0) {
+      amount = -amount
+    }
+    const value = amount * (await this.getOraclePrice(collateralToken)).getPriceUnchecked().getPriceAsNumberUnchecked() / (10 ** this.consts.coins[collateralToken].decimals)
+    const vaultPromises = Object.keys(this.consts.zoCore.vaults).map(async (vault) => {
+      const vaultInfo = await this.getVaultInfo(vault)
+      const reservingFeeDelta = USDZDataAPI.calculateVaultReservingFee(vaultInfo, vaultInfo.reservingFeeModel, Date.now() / 1000)
+      const res = (reservingFeeDelta + vaultInfo.liquidity + vaultInfo.reservedAmount) * (await this.getOraclePrice(vault)).getPriceUnchecked().getPriceAsNumberUnchecked() / (10 ** this.consts.coins[vault].decimals)
+      if (collateralToken === vault) {
+        vaultValue = res
+      }
+      return res
+    })
+
+    const vaultValues = await Promise.all(vaultPromises)
+    const totalVaultValue = vaultValues.reduce((acc, curr) => acc + curr, 0)
+    const targetRatio = Number.parseInt(
+      this.consts.zoCore.vaults[collateralToken].weight,
+      10,
+    ) / Object.values(this.consts.zoCore.vaults)
+      .map(e => Number.parseInt(e.weight, 10))
+      .reduce((acc, curr) => acc + curr, 0)
+
+    return USDZDataAPI.calcRebaseFeeRate(
+      await this.getRebaseFeeModel(),
+      increase,
+      (vaultValue + value) / (totalVaultValue + value),
+      targetRatio,
+    )
+  }
+
+  public async reservingFeeRate(collateralToken: string, amount = 0): Promise<number> {
+    const vaultInfo = await this.getVaultInfo(collateralToken)
+    const vaultSupply = vaultInfo.liquidity + vaultInfo.reservedAmount + vaultInfo.unrealisedReservingFeeAmount + amount
+    const utilization = vaultSupply ? ((vaultInfo.reservedAmount + amount) / vaultSupply) : 0
+    return USDZDataAPI.calcReservingFeeRate(vaultInfo.reservingFeeModel, utilization, SECONDS_PER_EIGHT_HOUR)
+  }
+
+  public async getHistory(trader: string, page: number, limit: number, orderType?: string, symbol?: string): Promise<IBaseHistoryResponse> {
+    const params = new URLSearchParams({
+      trader,
+      page: page.toString(),
+      limit: limit.toString(),
+    })
+
+    // Add filter parameters if provided
+    if (orderType && orderType !== 'all') {
+      params.append('orderType', orderType)
+    }
+    if (symbol && symbol !== 'all') {
+      params.append('symbol', symbol)
+    }
+
+    params.append('lpType', 'USDZ')
+    const url = `${this.apiEndpoint}/traderEvents?${params}`
+    const res = await fetch(url, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+    })
+    const response = await res.json() as any
+
+    return {
+      histories: response.data?.histories || [],
+      pagination: response.data?.pagination || {
+        total: 0,
+        page: 1,
+        limit: 20,
+        pages: 0,
+      },
+    }
+  }
+
+  // Private helper methods
+  private static calcFundingFeeRate(model: IUSDZFundingFeeModel, pnlPerRate: number, elapsed: number): number {
+    const dailyRate = Math.min(model.multiplier * Math.abs(pnlPerRate), model.max)
+    const secondsRate = dailyRate * elapsed / SECONDS_PER_EIGHT_HOUR
+    return pnlPerRate >= 0 ? -secondsRate : secondsRate
+  }
+
+  private static calcOiFundingFeeRate(model: IUSDZOiFundingModel, longSize: number, shortSize: number, elapsed: number): number {
+    const imbalance = Math.abs(longSize - shortSize)
+    const total = longSize + shortSize > 0 ? longSize + shortSize : 1
+    const dailyRate = Math.min((model.multiplier * (imbalance ** model.exponent)) / total, model.max)
+    const secondsRate = dailyRate * elapsed / SECONDS_PER_EIGHT_HOUR
+    return longSize >= shortSize ? secondsRate : -secondsRate
+  }
+
+  private static calcAccFundingFeeRate(
+    symbol: IUSDZSymbolInfo,
+    model: IUSDZFundingFeeModel,
+    price: number,
+    lpSupplyAmount: number,
+    timestamp: number,
+    oiModel?: IUSDZOiFundingModel,
+    pairedOpeningSize?: number,
+  ): number {
+    if (symbol.lastUpdate > 0) {
+      const elapsed = timestamp - symbol.lastUpdate
+      if (elapsed > 0) {
+        if (oiModel && typeof pairedOpeningSize === 'number') {
+          const longSize = symbol.long ? symbol.openingSize : pairedOpeningSize
+          const shortSize = symbol.long ? pairedOpeningSize : symbol.openingSize
+          const deltaRate = USDZDataAPI.calcOiFundingFeeRate(oiModel, longSize, shortSize, elapsed)
+          return symbol.accFundingRate + deltaRate
+        }
+        const deltaSize = USDZDataAPI.calcDeltaSize(symbol, price)
+        const pnlPerLp = (symbol.realisedPnl + symbol.unrealisedFundingFeeValue + deltaSize) / lpSupplyAmount
+        return symbol.accFundingRate + USDZDataAPI.calcFundingFeeRate(model, pnlPerLp, elapsed)
+      }
+    }
+    return symbol.accFundingRate
+  }
+
+  private static calculateSymbolFundingFee(
+    symbol: IUSDZSymbolInfo,
+    model: IUSDZFundingFeeModel,
+    price: number,
+    lpSupplyAmount: number,
+    timestamp: number,
+    oiModel?: IUSDZOiFundingModel,
+    pairedOpeningSize?: number,
+  ): number {
+    const accFundingRate = USDZDataAPI.calcAccFundingFeeRate(
+      symbol,
+      model,
+      price,
+      lpSupplyAmount,
+      timestamp,
+      oiModel,
+      pairedOpeningSize,
+    )
+    return symbol.unrealisedFundingFeeValue + (accFundingRate - symbol.accFundingRate) * symbol.openingSize
+  }
+
+  private static calculatePositionReserveFee(position: IUSDZPositionInfo, vault: IUSDZVaultInfo, model: IUSDZReservingFeeModel, timestamp: number): number {
+    const accReservingRate = USDZDataAPI.calcAccReservingFeeRate(vault, model, timestamp)
+    return position.reservingFeeAmount + (accReservingRate - position.lastReservingRate) * position.reservedAmount
+  }
+
+  private static calcAccReservingFeeRate(vault: IUSDZVaultInfo, model: IUSDZReservingFeeModel, timestamp: number): number {
+    if (vault.lastUpdate > 0) {
+      const elapsed = timestamp - vault.lastUpdate
+      if (elapsed > 0) {
+        const utilization = USDZDataAPI.vaultUtilization(vault)
+        return vault.accReservingRate + USDZDataAPI.calcReservingFeeRate(model, utilization, elapsed)
+      }
+    }
+    return vault.accReservingRate
+  }
+
+  private static calcRebaseFeeRate(model: IUSDZRebaseFeeModel, increase: boolean, ratio: number, targetRatio: number): number {
+    if ((increase && ratio <= targetRatio) || (!increase && ratio >= targetRatio)) {
+      return model.base
+    }
+    return model.base + model.multiplier * Math.abs(ratio - targetRatio)
+  }
+
+  private static vaultUtilization(vault: IUSDZVaultInfo): number {
+    const supplyAmount = vault.liquidity + vault.reservedAmount + vault.unrealisedReservingFeeAmount
+    if (supplyAmount === 0) {
+      return 0
+    }
+    return vault.reservedAmount / supplyAmount
+  }
+
+  private static calcReservingFeeRate(model: IUSDZReservingFeeModel, utilization: number, elapsed: number): number {
+    return model.multiplier * utilization * elapsed / SECONDS_PER_EIGHT_HOUR
+  }
+
+  private static calcDeltaSize(symbol: IUSDZSymbolInfo, price: number): number {
+    const latestSize = symbol.openingAmount / symbol.priceConfig.precision * price
+    return symbol.long ? symbol.openingSize - latestSize : latestSize - symbol.openingSize
+  }
+
+  private static parseMarketInfo(raw: any): IUSDZMarketInfo {
+    const content = raw.data.content.fields
+
+    return {
+      lpSupply: content.lp_supply.fields.value,
+      positionId: content.positions.fields.id.id,
+      vaultId: content.vaults.fields.id.id,
+      symbolId: content.symbols.fields.id.id,
+      referralId: content.referrals.fields.id.id,
+      orderId: content.orders.fields.id.id,
+      rebaseFeeModel: content.rebase_fee_model,
+      lpSupplyWithDecimals: content.lp_supply.fields.value / (10 ** USDZ_TOKEN_DECIMALS),
+    }
+  }
+
+  private async parseVaultInfo(raw: any): Promise<IUSDZVaultInfo> {
+    const vaultFields = raw.data.content.fields.value.fields
+    const reservingFeeModelAddr = vaultFields.reserving_fee_model
+    const reservingFeeModelRaw = await this.provider.getObject({
+      id: reservingFeeModelAddr,
+      options: {
+        showContent: true,
+      },
+    })
+    const reservingFeeModel = USDZDataAPI.parseReservingFeeModel(reservingFeeModelRaw)
+
+    return {
+      liquidity: parseValue(vaultFields.liquidity),
+      reservedAmount: parseValue(vaultFields.reserved_amount),
+      unrealisedReservingFeeAmount: parseValue(
+        vaultFields.unrealised_reserving_fee_amount,
+      ),
+      accReservingRate: parseValue(vaultFields.acc_reserving_rate),
+      enabled: vaultFields.enabled,
+      weight: parseValue(vaultFields.weight),
+      lastUpdate: parseValue(vaultFields.last_update),
+      reservingFeeModel,
+      priceConfig: {
+        maxInterval: parseValue(vaultFields.price_config.fields.max_interval),
+        maxConfidence: parseValue(vaultFields.price_config.fields.max_confidence),
+        precision: parseValue(vaultFields.price_config.fields.precision),
+        feeder: vaultFields.price_config.fields.feeder,
+      },
+    }
+  }
+
+  private async parseSymbolInfo(raw: any, long: boolean): Promise<IUSDZSymbolInfo> {
+    const { objectId } = raw.data
+    const { fields } = raw.data.content.fields.value
+    const fundingFeeModelAddr = fields.funding_fee_model
+    const fundingFeeModelRaw = await this.provider.getObject({
+      id: fundingFeeModelAddr,
+      options: {
+        showContent: true,
+      },
+    })
+    const fundingFeeModel = USDZDataAPI.parseFundingFeeModel(fundingFeeModelRaw)
+
+    return {
+      objectId,
+      openingSize: parseValue(fields.opening_size),
+      openingAmount: parseValue(fields.opening_amount),
+      accFundingRate: parseValue(fields.acc_funding_rate),
+      realisedPnl: parseValue(fields.realised_pnl),
+      unrealisedFundingFeeValue: parseValue(fields.unrealised_funding_fee_value),
+      openEnabled: fields.open_enabled,
+      liquidateEnabled: fields.liquidate_enabled,
+      decreaseEnabled: fields.decrease_enabled,
+      lastUpdate: parseValue(fields.last_update),
+      fundingFeeModel,
+      long,
+      priceConfig: {
+        maxInterval: parseValue(fields.price_config.fields.max_interval),
+        maxConfidence: parseValue(fields.price_config.fields.max_confidence),
+        precision: parseValue(fields.price_config.fields.precision),
+        feeder: fields.price_config.fields.feeder,
+      },
+    }
+  }
+
+  private static parsePositionConfig(raw: any): IUSDZPositionConfig {
+    const positionConfigFields = raw.data.content.fields.inner.fields
+
+    return {
+      decreaseFeeBps: parseValue(positionConfigFields.decrease_fee_bps),
+      liquidationBonus: parseValue(positionConfigFields.liquidation_bonus),
+      liquidationThreshold: parseValue(positionConfigFields.liquidation_threshold),
+      maxLeverage: parseValue(positionConfigFields.max_leverage),
+      minHoldingDuration: parseValue(positionConfigFields.min_holding_duration),
+      openFeeBps: parseValue(positionConfigFields.open_fee_bps),
+      maxReservedMultiplier: parseValue(positionConfigFields.max_reserved_multiplier),
+      minCollateralValue: parseValue(positionConfigFields.min_collateral_value),
+    }
+  }
+
+  private static parseSymbolConfig(raw: any): IUSDZSymbolConfig {
+    const { fields } = raw.data.content
+
+    return {
+      id: fields.id.id,
+      max_opening_size: parseValue(fields.max_opening_size),
+      max_opening_size_enabled: fields.max_opening_size_enabled,
+      max_opening_size_per_position: parseValue(fields.max_opening_size_per_position),
+      max_opening_size_per_position_enabled: fields.max_opening_size_per_position_enabled,
+      instant_exit_fee_config: {
+        instant_exit_tier_1_duration_threshold: parseValue(fields.instant_exit_fee_config.fields.instant_exit_tier_1_duration_threshold),
+        instant_exit_tier_1_fee_bps: parseValue(fields.instant_exit_fee_config.fields.instant_exit_tier_1_fee_bps.fields.value),
+        instant_exit_tier_1_fee_enabled: fields.instant_exit_fee_config.fields.instant_exit_tier_1_fee_enabled,
+        instant_exit_tier_2_duration_threshold: parseValue(fields.instant_exit_fee_config.fields.instant_exit_tier_2_duration_threshold),
+        instant_exit_tier_2_fee_bps: parseValue(fields.instant_exit_fee_config.fields.instant_exit_tier_2_fee_bps.fields.value),
+        instant_exit_tier_2_fee_enabled: fields.instant_exit_fee_config.fields.instant_exit_tier_2_fee_enabled,
+        instant_exit_tier_3_duration_threshold: parseValue(fields.instant_exit_fee_config.fields.instant_exit_tier_3_duration_threshold),
+        instant_exit_tier_3_fee_bps: parseValue(fields.instant_exit_fee_config.fields.instant_exit_tier_3_fee_bps.fields.value),
+        instant_exit_tier_3_fee_enabled: fields.instant_exit_fee_config.fields.instant_exit_tier_3_fee_enabled,
+      },
+    }
+  }
+
+  private async parsePositionInfo(raw: any, id_: string): Promise<IUSDZPositionInfo> {
+    const { content } = raw.data
+    const { fields } = content
+    const positionFields = fields.value.fields
+    const dataType = fields.name.type
+
+    const positionInfo = {
+      id: id_,
+      long: dataType.includes('::market::LONG'),
+      owner: fields.name.fields.owner,
+      version: Number.parseInt(raw.data.version, 10),
+      collateralToken: suiSymbolToSymbol(dataType.split('<')[1].split(',')[0].trim(), this.consts),
+      indexToken: suiSymbolToSymbol(dataType.split(',')[1].trim(), this.consts),
+      collateralAmount: parseValue(positionFields.collateral),
+      positionAmount: parseValue(positionFields.position_amount),
+      reservedAmount: parseValue(positionFields.reserved),
+      positionSize: parseValue(positionFields.position_size),
+      lastFundingRate: parseValue(positionFields.last_funding_rate),
+      lastReservingRate: parseValue(positionFields.last_reserving_rate),
+      reservingFeeAmount: parseValue(positionFields.reserving_fee_amount),
+      fundingFeeValue: parseValue(positionFields.funding_fee_value),
+      closed: positionFields.closed,
+      openTimestamp: parseValue(positionFields.open_timestamp),
+    }
+
+    positionInfo.reservingFeeAmount = USDZDataAPI.calculatePositionReserveFee(
+      positionInfo,
+      await this.getVaultInfo(positionInfo.collateralToken),
+      (await this.getVaultInfo(positionInfo.collateralToken)).reservingFeeModel,
+      Date.now() / 1000,
+    )
+
+    // OI context for funding: fetch state and paired side size when enabled
+    const oiState = await this.getSymbolOiFundingState(positionInfo.indexToken)
+    const pairedSymbol = await this.getSymbolInfo(positionInfo.indexToken, !positionInfo.long)
+    positionInfo.fundingFeeValue = USDZDataAPI.calculatePositionFundingFee(
+      positionInfo,
+      await this.getSymbolInfo(positionInfo.indexToken, positionInfo.long),
+      (await this.getSymbolInfo(positionInfo.indexToken, positionInfo.long)).fundingFeeModel,
+      (await this.getOraclePrice(positionInfo.indexToken)).getPriceUnchecked().getPriceAsNumberUnchecked(),
+      (await this.getMarketInfo()).lpSupplyWithDecimals,
+      Date.now() / 1000,
+      oiState && oiState.enabled ? oiState.model : undefined,
+      pairedSymbol.openingSize,
+    )
+
+    return positionInfo
+  }
+
+  private static calculatePositionFundingFee(
+    position: IUSDZPositionInfo,
+    symbol: IUSDZSymbolInfo,
+    model: IUSDZFundingFeeModel,
+    price: number,
+    lpSupplyAmount: number,
+    timestamp: number,
+    oiModel?: IUSDZOiFundingModel,
+    pairedOpeningSize?: number,
+  ): number {
+    const accFundingRate = USDZDataAPI.calcAccFundingFeeRate(
+      symbol,
+      model,
+      price,
+      lpSupplyAmount,
+      timestamp,
+      oiModel,
+      pairedOpeningSize,
+    )
+    return position.fundingFeeValue + (accFundingRate - position.lastFundingRate) * position.positionSize
+  }
+
+  private static parseRebaseFeeModel(raw: any): { base: number, multiplier: number } {
+    const { fields } = raw.data.content
+
+    return {
+      base: parseValue(fields.base),
+      multiplier: parseValue(fields.multiplier),
+    }
+  }
+
+  private static parseReservingFeeModel(raw: any): { multiplier: number } {
+    const content = raw.data.content.fields
+    return {
+      multiplier: parseValue(content.multiplier),
+    }
+  }
+
+  private static parseFundingFeeModel(raw: any): { multiplier: number, max: number } {
+    const content = raw.data.content.fields
+    return {
+      multiplier: parseValue(content.multiplier),
+      max: parseValue(content.max),
+    }
+  }
+
+  private static parseOiFundingState(raw: any): IUSDZOiFundingState {
+    const content = raw.data.content.fields
+    return {
+      id: content.id.id,
+      enabled: content.enabled,
+      last_update: parseValue(content.last_update),
+      model: {
+        id: content.model.fields.id.id,
+        multiplier: parseValue(content.model.fields.multiplier),
+        exponent: parseValue(content.model.fields.exponent),
+        max: parseValue(content.model.fields.max),
+      },
+    }
+  }
+
+  private static parsePriceImpactConfig(raw: any): IUSDZPriceImpactConfig {
+    const content = raw.data.content.fields
+    return {
+      id: content.id.id,
+      enabled: content.enabled,
+      baseSpreadRate: parseValue(content.base_spread_rate),
+      maxDynamicSpreadRate: parseValue(content.max_dynamic_spread_rate),
+      maxTotalSpreadRate: parseValue(content.max_total_spread_rate),
+      impactExponent: parseValue(content.impact_exponent),
+      maxOiLong: parseValue(content.max_oi_long),
+      maxOiShort: parseValue(content.max_oi_short),
+      referenceSize: parseValue(content.reference_size),
+    }
+  }
+
+  /**
+   * Computes the spread rate based on OI skew between long and short sides using point evaluation.
+   * This is the offchain equivalent of price_impact::compute_spread_rate in the Move contract.
+   *
+   * NOTE: This method uses point evaluation at the final state. For large trades,
+   * use computeAverageSpreadRate() instead, which integrates over the trade path
+   * for more accurate pricing.
+   *
+   * @param config - Price impact configuration for the symbol
+   * @param currentOiThisSide - Current OI on the side being traded (in value terms)
+   * @param newPositionSize - Size of the new position in value terms
+   * @param currentOiOpposite - Current OI on the opposite side (in value terms)
+   * @param maxOiThisSide - Maximum OI for this side (from config or SymbolConfig)
+   * @param maxOiOpposite - Maximum OI for opposite side (from config or SymbolConfig)
+   * @returns Total spread rate to apply (as a decimal, e.g., 0.001 = 0.1%)
+   */
+  public static computeSpreadRate(
+    config: IUSDZPriceImpactConfig,
+    currentOiThisSide: number,
+    newPositionSize: number,
+    currentOiOpposite: number,
+    maxOiThisSide: number,
+    maxOiOpposite: number,
+  ): number {
+    // If not enabled, return zero spread
+    if (!config.enabled) {
+      return 0
+    }
+
+    // If maxOiThisSide is zero, return base spread only (cannot compute utilization)
+    if (maxOiThisSide === 0) {
+      return config.baseSpreadRate
+    }
+
+    // Calculate this side utilization: (current_oi + new_position) / max_oi
+    const totalOiThis = currentOiThisSide + newPositionSize
+    const thisUtil = Math.min(totalOiThis / maxOiThisSide, 1)
+
+    // Calculate opposite side utilization: current_oi / max_oi
+    let oppositeUtil = 0
+    if (maxOiOpposite > 0) {
+      oppositeUtil = Math.min(currentOiOpposite / maxOiOpposite, 1)
+    }
+
+    // Calculate skew_ratio = this_util - opposite_util, clamped to [0, 1]
+    // Positive when this side is more utilized (crowded), which increases spread
+    let skewRatio = thisUtil - oppositeUtil
+    if (skewRatio < 0) {
+      skewRatio = 0 // No penalty when opposite side is more crowded
+    }
+    else if (skewRatio > 1) {
+      skewRatio = 1 // Cap at 1.0
+    }
+
+    // Calculate dynamic_spread = max_dynamic * (skew_ratio ^ exponent)
+    // For fractional exponents, use linear interpolation
+    const exponent = config.impactExponent
+    const exponentInt = Math.floor(exponent)
+    const exponentFrac = exponent - exponentInt
+
+    // Compute base^exponent_int
+    let ratioPowered = skewRatio ** exponentInt
+
+    // For fractional exponent, interpolate: result = base^n + frac * (base^(n+1) - base^n)
+    if (exponentFrac > 0) {
+      const ratioPoweredNext = skewRatio ** (exponentInt + 1)
+      const diff = ratioPoweredNext - ratioPowered
+      if (diff >= 0) {
+        ratioPowered += exponentFrac * diff
+      }
+    }
+
+    // dynamic_spread = max_dynamic_spread * final_ratio
+    const dynamicSpread = config.maxDynamicSpreadRate * ratioPowered
+
+    // total_spread = base_spread + dynamic_spread
+    let totalSpread = config.baseSpreadRate + dynamicSpread
+
+    // Cap at max_total_spread
+    if (totalSpread > config.maxTotalSpreadRate) {
+      totalSpread = config.maxTotalSpreadRate
+    }
+
+    return totalSpread
+  }
+
+  /**
+   * Computes the size factor multiplier based on position size.
+   * Formula: size_factor = 1 + min(1, position_size / reference_size)
+   *
+   * @param positionSize - Size of the new position
+   * @param referenceSize - Reference size for scaling (0 = disabled)
+   * @returns Size factor multiplier (1.0 to 2.0)
+   */
+  private static computeSizeFactor(
+    positionSize: number,
+    referenceSize: number,
+  ): number {
+    // If reference_size is zero, size scaling is disabled
+    if (referenceSize === 0) {
+      return 1
+    }
+
+    // Compute position_size / reference_size, capped at 1
+    const ratio = Math.min(positionSize / referenceSize, 1)
+
+    // Return 1 + capped_ratio
+    return 1 + ratio
+  }
+
+  /**
+   * Computes the average value of max_dynamic * s^n over the interval [s1, s2].
+   * Uses the integral formula: average = max_dynamic * (s2^(n+1) - s1^(n+1)) / ((n+1) * (s2 - s1))
+   *
+   * @param maxDynamic - Maximum dynamic spread rate
+   * @param s1 - Start skew ratio
+   * @param s2 - End skew ratio
+   * @param exponent - Impact exponent
+   * @returns Average dynamic spread rate
+   */
+  private static computeIntegralAverage(
+    maxDynamic: number,
+    s1: number,
+    s2: number,
+    exponent: number,
+  ): number {
+    // If s1 == s2, return point evaluation
+    if (s1 === s2) {
+      return maxDynamic * (s1 ** exponent)
+    }
+
+    // Compute n + 1
+    const nPlus1 = exponent + 1
+
+    // Compute s2^(n+1) and s1^(n+1)
+    const s2Pow = s2 ** nPlus1
+    const s1Pow = s1 ** nPlus1
+
+    // Compute numerator: s2^(n+1) - s1^(n+1)
+    const numerator = Math.abs(s2Pow - s1Pow)
+
+    // Compute denominator: (n+1) * (s2 - s1)
+    const sDiff = Math.abs(s2 - s1)
+    const denominator = nPlus1 * sDiff
+
+    // Avoid division by zero
+    if (denominator === 0) {
+      return 0
+    }
+
+    // Compute average ratio and multiply by max_dynamic
+    return maxDynamic * (numerator / denominator)
+  }
+
+  /**
+   * Computes the average spread rate over the trade path with size scaling.
+   * This is the offchain equivalent of price_impact::compute_average_spread_rate in the Move contract.
+   *
+   * This function integrates the spread over the utilization change rather than
+   * using the final-state spread, and applies a size-based multiplier to the
+   * dynamic spread component.
+   *
+   * @param config - Price impact configuration for the symbol
+   * @param currentOiThisSide - Current OI on the side being traded (in value terms)
+   * @param newPositionSize - Size of the new position in value terms
+   * @param currentOiOpposite - Current OI on the opposite side (in value terms)
+   * @param maxOiThisSide - Maximum OI for this side (from config or SymbolConfig)
+   * @param maxOiOpposite - Maximum OI for opposite side (from config or SymbolConfig)
+   * @returns Total spread rate to apply (as a decimal, e.g., 0.001 = 0.1%)
+   */
+  public static computeAverageSpreadRate(
+    config: IUSDZPriceImpactConfig,
+    currentOiThisSide: number,
+    newPositionSize: number,
+    currentOiOpposite: number,
+    maxOiThisSide: number,
+    maxOiOpposite: number,
+  ): number {
+    // If not enabled, return zero spread
+    if (!config.enabled) {
+      return 0
+    }
+
+    // If maxOiThisSide is zero, return base spread only (cannot compute utilization)
+    if (maxOiThisSide === 0) {
+      return config.baseSpreadRate
+    }
+
+    // Calculate opposite side utilization (constant throughout the trade)
+    let oppositeUtil = 0
+    if (maxOiOpposite > 0) {
+      oppositeUtil = Math.min(currentOiOpposite / maxOiOpposite, 1)
+    }
+
+    // Calculate start utilization: current_oi / max_oi
+    const startUtil = Math.min(currentOiThisSide / maxOiThisSide, 1)
+
+    // Calculate end utilization: (current_oi + new_position) / max_oi
+    const totalOiThis = currentOiThisSide + newPositionSize
+    const endUtil = Math.min(totalOiThis / maxOiThisSide, 1)
+
+    // Calculate start skew: max(0, min(1, start_util - opposite_util))
+    let startSkew = startUtil - oppositeUtil
+    if (startSkew < 0) {
+      startSkew = 0
+    }
+    else if (startSkew > 1) {
+      startSkew = 1
+    }
+
+    // Calculate end skew: max(0, min(1, end_util - opposite_util))
+    let endSkew = endUtil - oppositeUtil
+    if (endSkew < 0) {
+      endSkew = 0
+    }
+    else if (endSkew > 1) {
+      endSkew = 1
+    }
+
+    // Compute average dynamic spread via integral
+    const avgDynamicRate = USDZDataAPI.computeIntegralAverage(
+      config.maxDynamicSpreadRate,
+      startSkew,
+      endSkew,
+      config.impactExponent,
+    )
+
+    // Apply size scaling factor to dynamic spread
+    const sizeFactor = USDZDataAPI.computeSizeFactor(newPositionSize, config.referenceSize)
+    const scaledDynamicRate = avgDynamicRate * sizeFactor
+
+    // total_spread = base_spread + scaled_dynamic
+    let totalSpread = config.baseSpreadRate + scaledDynamicRate
+
+    // Cap at max_total_spread
+    if (totalSpread > config.maxTotalSpreadRate) {
+      totalSpread = config.maxTotalSpreadRate
+    }
+
+    return totalSpread
+  }
+
+  /**
+   * Applies price impact to a price.
+   * This is the offchain equivalent of price_impact::apply_price_impact in the Move contract.
+   *
+   * Direction logic:
+   * - Open Long: price INCREASES (pay more)
+   * - Open Short: price DECREASES (receive less)
+   * - Close Long: price DECREASES (receive less)
+   * - Close Short: price INCREASES (pay more)
+   *
+   * @param originalPrice - The original price
+   * @param spreadRate - The spread rate to apply (as a decimal, e.g., 0.001 = 0.1%)
+   * @param isLong - Whether this is a long position
+   * @param isOpening - Whether this is opening (true) or closing (false)
+   * @returns Adjusted price with spread applied
+   */
+  public static applyPriceImpact(
+    originalPrice: number,
+    spreadRate: number,
+    isLong: boolean,
+    isOpening: boolean,
+  ): number {
+    // If spread is zero, return original price
+    if (spreadRate === 0) {
+      return originalPrice
+    }
+
+    // Determine if we should increase or decrease price
+    // Open Long or Close Short -> increase price
+    // Open Short or Close Long -> decrease price
+    const increasePrice = (isLong && isOpening) || (!isLong && !isOpening)
+
+    // Calculate spread amount: price * spread_rate
+    const spreadAmount = originalPrice * spreadRate
+
+    // Apply spread
+    if (increasePrice) {
+      return originalPrice + spreadAmount
+    }
+
+    // Ensure we don't go negative
+    const adjusted = originalPrice - spreadAmount
+    return Math.max(adjusted, 0)
+  }
+
+  /**
+   * Convenience method to compute the estimated execution price with price impact.
+   * Fetches the required data and computes the adjusted price.
+   *
+   * @param indexToken - The index token symbol (e.g., 'sui', 'btc')
+   * @param isLong - Whether this is a long position
+   * @param isOpening - Whether this is opening or closing
+   * @param positionSizeValue - Size of the position in value terms (USD)
+   * @returns Object containing spread rate and adjusted price, or null if price impact not configured
+   */
+  public async estimatePriceImpact(
+    indexToken: string,
+    isLong: boolean,
+    isOpening: boolean,
+    positionSizeValue: number,
+  ): Promise<{ spreadRate: number, originalPrice: number, adjustedPrice: number } | null> {
+    const config = await this.getPriceImpactConfig(indexToken)
+    if (!config) {
+      return null
+    }
+
+    // Get current OI for both sides
+    const longSymbol = await this.getSymbolInfo(indexToken, true)
+    const shortSymbol = await this.getSymbolInfo(indexToken, false)
+
+    // Get oracle price
+    const oraclePrice = (await this.getOraclePrice(indexToken)).getPriceUnchecked().getPriceAsNumberUnchecked()
+
+    // Determine which side is "this" side and which is "opposite"
+    const currentOiThisSide = isLong ? longSymbol.openingSize : shortSymbol.openingSize
+    const currentOiOpposite = isLong ? shortSymbol.openingSize : longSymbol.openingSize
+    const maxOiThisSide = isLong ? config.maxOiLong : config.maxOiShort
+    const maxOiOpposite = isLong ? config.maxOiShort : config.maxOiLong
+
+    // Compute average spread rate (uses integration for better accuracy on large trades)
+    const spreadRate = USDZDataAPI.computeAverageSpreadRate(
+      config,
+      currentOiThisSide,
+      positionSizeValue,
+      currentOiOpposite,
+      maxOiThisSide,
+      maxOiOpposite,
+    )
+
+    // Apply price impact
+    const adjustedPrice = USDZDataAPI.applyPriceImpact(oraclePrice, spreadRate, isLong, isOpening)
+
+    return {
+      spreadRate,
+      originalPrice: oraclePrice,
+      adjustedPrice,
+    }
+  }
+
+  private parseOrderInfo(raw: any, capId: string): IUSDZOrderInfo {
+    const { content } = raw.data
+    const { fields } = content.fields.value
+
+    // Extract tokens from dataType
+    const dataType = content?.type
+
+    let orderType: IBaseOrderType
+    if (content.fields.value?.type.includes('OpenPositionOrder')) {
+      orderType = 'OPEN_POSITION'
+    }
+    else if (content.fields.value?.type.includes('OpenMarketOrder')) {
+      orderType = 'OPEN_MARKET'
+    }
+    else if (content.fields.value?.type.includes('DecreasePositionOrder')) {
+      orderType = 'DECREASE_POSITION'
+    }
+    else {
+      orderType = 'DECREASE_MARKET'
+    }
+
+    const ret: IUSDZOrderInfo = {
+      id: content.fields.id.id,
+      capId,
+      executed: fields.executed,
+      owner: content.fields.name.fields.owner,
+      collateralToken: suiSymbolToSymbol(dataType.split('<')[2].split(',')[0].trim(), this.consts),
+      indexToken: suiSymbolToSymbol(dataType.split(',')[1].trim(), this.consts),
+      feeToken: suiSymbolToSymbol(dataType.split(',')[3].split('>')[0].trim(), this.consts),
+      // Use index_price for open orders, limited_index_price for decrease orders
+      indexPrice: orderType === 'OPEN_MARKET'
+        ? parseValue(fields.index_price)
+        : parseValue(fields.limited_index_price?.fields?.price || fields.limited_index_price),
+      collateralPriceThreshold: fields.collateral_price_threshold ? parseValue(fields.collateral_price_threshold) : 0,
+      // New index price threshold
+      indexPriceThreshold: fields.index_price_threshold ? parseValue(fields.index_price_threshold) : undefined,
+      feeAmount: BigInt(fields.fee),
+      long: dataType.includes('::market::LONG'),
+      orderType,
+      createdAt: parseValue(fields.created_at),
+      v11Order: !fields.limited_index_price?.fields?.price,
+      // New: referrer and scard fields
+      referrer: fields.referrer,
+      scardId: (
+        fields.scard_id?.fields?.some?.fields?.id
+        || fields.scard_id?.fields?.value?.fields?.id
+        || fields.scard_id?.fields?.id
+        || fields.scard_id?.id
+      ),
+      scardRebateRate: (() => {
+        const inner = fields.scard_rebate_rate?.fields?.some ?? fields.scard_rebate_rate?.fields?.value
+        return inner ? parseValue(inner) : undefined
+      })(),
+    }
+
+    if (orderType === 'OPEN_POSITION' || orderType === 'OPEN_MARKET') {
+      ret.openOrder = {
+        reserveAmount: BigInt(fields.reserve_amount),
+        collateralAmount: BigInt(fields.collateral),
+        openAmount: BigInt(fields.open_amount),
+        // New: position_config from OpenMarketOrder
+        positionConfig: fields.position_config?.fields
+          ? {
+              decreaseFeeBps: parseValue(fields.position_config.fields.decrease_fee_bps),
+              liquidationBonus: parseValue(fields.position_config.fields.liquidation_bonus),
+              liquidationThreshold: parseValue(fields.position_config.fields.liquidation_threshold),
+              maxLeverage: parseValue(fields.position_config.fields.max_leverage),
+              minHoldingDuration: parseValue(fields.position_config.fields.min_holding_duration),
+              openFeeBps: parseValue(fields.position_config.fields.open_fee_bps),
+              maxReservedMultiplier: parseValue(fields.position_config.fields.max_reserved_multiplier),
+              minCollateralValue: parseValue(fields.position_config.fields.min_collateral_value),
+            }
+          : undefined,
+      }
+    }
+    else if (orderType === 'DECREASE_POSITION' || orderType === 'DECREASE_MARKET') {
+      ret.decreaseOrder = {
+        decreaseAmount: BigInt(fields.decrease_amount),
+        takeProfit: fields.take_profit,
+      }
+    }
+
+    return ret
+  }
+
+  private static calculateVaultReservingFee(
+    vaultInfo: IUSDZVaultInfo,
+    reservingFeeModel: { multiplier: number },
+    currentTime: number,
+  ): number {
+    const timeDelta = currentTime - vaultInfo.lastUpdate
+    const periods = Math.floor(timeDelta / SECONDS_PER_EIGHT_HOUR)
+    return vaultInfo.unrealisedReservingFeeAmount
+      + (vaultInfo.reservedAmount * reservingFeeModel.multiplier * periods) / 1e18
+  }
+
+  private static parseCredential(raw: any, pool: IUSDZStakePool): IUSDZCredential {
+    const stakedAmount = BigInt(raw.data.content.fields.stake)
+    const accRewardPerShare = BigInt(
+      raw.data.content.fields.acc_reward_per_share,
+    )
+    return {
+      id: raw.data.objectId,
+      lockUntil: parseValue(raw.data.content.fields.lock_until),
+      amount: stakedAmount,
+      accRewardPerShare,
+      claimable:
+        ((pool.accRewardPerShare - accRewardPerShare) * stakedAmount)
+        / BigInt(1e18),
+    }
+  }
+
+  private static parseStakePool(raw: any): IUSDZStakePool {
+    const content = raw.data.content.fields
+    const pool = {
+      id: content.id.id,
+      enabled: content.enabled,
+      lastUpdatedTime: parseValue(content.last_updated_time),
+      stakedAmount: BigInt(content.staked_amount),
+      reward: BigInt(content.reward_vault),
+      startTime: parseValue(content.start_time),
+      endTime: parseValue(content.end_time),
+      rewardRate: BigInt(content.reward_rate),
+      accRewardPerShare: BigInt(content.acc_reward_per_share),
+      lockDuration: parseValue(content.lock_duration),
+    }
+    USDZDataAPI.refreshPool(pool, Math.floor(Date.now() / 1000))
+    return pool
+  }
+
+  private static refreshPool(pool: IUSDZStakePool, timestamp: number): void {
+    if (timestamp <= pool.lastUpdatedTime || timestamp < pool.startTime) {
+      return
+    }
+
+    const applicableEndTime = Math.max(pool.endTime, pool.lastUpdatedTime)
+
+    const calculationEndTime = Math.min(timestamp, applicableEndTime)
+
+    if (calculationEndTime > pool.lastUpdatedTime && pool.stakedAmount > BigInt(0) && pool.rewardRate > BigInt(0)) {
+      const timeDiff = BigInt(calculationEndTime - pool.lastUpdatedTime)
+      const rewardAmount = timeDiff * pool.rewardRate
+      const rewardPerShare = (rewardAmount * BigInt(1e18)) / pool.stakedAmount
+      pool.accRewardPerShare += rewardPerShare
+    }
+
+    pool.lastUpdatedTime = calculationEndTime
+  }
+}