@pear-protocol/types 2.21.0 → 2.22.0

package/dist/statistics/entities.js

@@ -1,105 +0,0 @@
-import { z } from 'zod';
-import { Connector } from '../connector';
-import { CopyFollower } from '../copy/entities';
-
-const LeaderboardRow = z.object({
-  // The row's identity, and the only safe key to render or join by.
-  tradeAccountId: z.string(),
-  // The trader the account belongs to, so a consumer can group the several rows one person
-  // earns across venues. The board deliberately publishes no exchange identifier: a wallet
-  // address beside a real name and a PnL deanonymizes a trader for good, and an address is
-  // not reversible once scraped. Neither id here is a credential — every route that takes
-  // one checks ownership or role, never knowledge of the id.
-  // This guarantee applies to private routes. Shared public profiles are addressable by
-  // tradeAccountId and omit the exchange identifier, including when the owner shows X identity.
-  userId: z.string(),
-  connector: Connector,
-  // Followers when this board was cached, independent of the performance date range.
-  followers: z.array(CopyFollower),
-  followerCount: z.number().int().nonnegative(),
-  // Every fill inside the window, whatever period its position began in — so unlike the
-  // money fields below, this can report trading whose fees and PnL belong to another window.
-  volume: z.string(),
-  // Positions the window watched open, as are the fees and the return beside them.
-  grossRealizedPnl: z.string(),
-  // Zero once the window has closed — unrealized PnL is a value as of now, so only a window
-  // that still contains now can report it. A window ending in the future does.
-  grossUpnl: z.string(),
-  // Net funding carry over the range, signed: negative when the trader paid to hold.
-  // Account-level, so a client-scoped board reports the account's whole carry —
-  // funding_payments carries no position id to attribute it any finer.
-  fundingPayment: z.string(),
-  totalNetPnl: z.string(),
-  // V2 calls this builderFee; V3 names it for the column it comes from.
-  pearFee: z.string(),
-  tradeFee: z.string(),
-  totalTrades: z.number(),
-  // This account's return over the window, as a ratio: "0.25" is +25%. The measured
-  // positions' PnL divided by the capital that earned it, so each position weighs by the
-  // money it put at risk — a measure of how the account's dollars did, not of how its
-  // individual calls went.
-  //
-  // One formula on every position: (realized + unrealized - fees paid) over the most cash that
-  // position had committed at one time. A closed position holds nothing, so its unrealized half
-  // is zero and this reduces to what the trader kept; a partly reduced open position counts
-  // both the profit it banked and the worth of what it still holds. Only fees of fills that
-  // happened are charged, so a running position never pays for the exit it has not made.
-  //
-  // The denominator is cash committed, not market value: each opening fill adds what it paid,
-  // each closing fill releases the share of that commitment the quantity it closed was holding,
-  // and the peak of that running total is what the return is measured against. So it is not the
-  // size the position opened at — a position scaled up afterwards is measured against what it
-  // went on to risk — and not the sum of everything it ever opened either, since capital
-  // reduced and recommitted counts once rather than twice.
-  //
-  // Measuring cash rather than market value is deliberate. A market-value denominator can fall
-  // below the money actually put in when a position is averaged down, which inflates the
-  // return; and no historical price series is kept, so market value could only ever be sampled
-  // at the fills themselves.
-  //
-  // Measured only where the window holds both the position's open and the moment the
-  // measurement is taken at: now for a running position, the closing fill for a finished
-  // one. A position that closed after the window ended is therefore left out — the window
-  // holds only part of what it realized, and part of a return is not a return.
-  //
-  // Absent when the board could measure none of the account's positions — never "0", which
-  // would claim a break-even trader. An account reaches the board with nothing measurable
-  // when its only trading in the window closed positions opened before it, when a closed
-  // window left its open positions unpriced, or when every position it opened in the window
-  // closed after it.
-  roi: z.string().optional(),
-  // The trader's linked X account, published to every caller — the board names its traders
-  // on the open internet, signed in or not. Absent for an account whose owner has connected
-  // no X account, and absent for one who hid the link from the board. Never null-with-a-key:
-  // absence is the signal.
-  //
-  // Whatever X reported at the owner's last authorization. Nothing re-reads X in between,
-  // so a trader who renamed and has not signed in since is named by their old handle.
-  xHandle: z.string().optional(),
-  xName: z.string().optional(),
-  xAvatarUrl: z.string().optional(),
-  // Immutable X numeric id. Link by this, never by the handle: X frees a renamed handle
-  // for anyone to claim immediately, so a cached handle can point at a stranger.
-  xUserId: z.string().optional()
-});
-const VolumeStatistics = z.object({
-  timestamp: z.number(),
-  volume: z.number(),
-  fees: z.number(),
-  trades: z.number(),
-  users: z.number(),
-  newUsers: z.number()
-});
-const OiStatistics = z.object({
-  timestamp: z.number(),
-  openInterest: z.number(),
-  openPositions: z.number()
-});
-const StatisticsTotals = z.object({
-  totalVolume: z.number(),
-  totalFees: z.number(),
-  totalTrades: z.number(),
-  totalUsers: z.number()
-});
-
-export { LeaderboardRow, OiStatistics, StatisticsTotals, VolumeStatistics };

package/dist/statistics/index.js

@@ -1,3 +0,0 @@
-export * from './entities';
-export * from './queries';
-export * from './responses';

package/dist/statistics/queries.js

@@ -1,111 +0,0 @@
-import { z } from 'zod';
-import { normalizeArray } from '../common/array';
-import { Connector } from '../connector';
-
-const VolumeStatisticsQueryParams = z.object({
-  connector: Connector.optional(),
-  resolution: z.enum([
-    "1h",
-    "4h",
-    "24h"
-  ]),
-  startDate: z.coerce.date().optional(),
-  endDate: z.coerce.date().default(() => /* @__PURE__ */ new Date()),
-  // Per-client scope; absent serves the global series. The literal 'other'
-  // selects the unattributed (NULL) bucket; an unknown code returns an empty series.
-  clientId: z.string().trim().min(1).optional()
-}).refine((data) => !data.startDate || data.startDate < data.endDate, {
-  message: "startDate must be before endDate"
-});
-const OiStatisticsQueryParams = z.object({
-  connector: Connector.optional(),
-  resolution: z.enum([
-    "1h",
-    "4h",
-    "24h"
-  ]),
-  startDate: z.coerce.date().optional(),
-  endDate: z.coerce.date().default(() => /* @__PURE__ */ new Date()),
-  // Per-client scope; absent serves the global series. The literal 'other'
-  // selects the unattributed (NULL) bucket; an unknown code returns an empty series.
-  clientId: z.string().trim().min(1).optional()
-}).refine((data) => !data.startDate || data.startDate < data.endDate, {
-  message: "startDate must be before endDate"
-});
-const StatisticsTotalsQueryParams = z.object({
-  connector: Connector.optional(),
-  // Per-client scope; absent serves the global totals. The literal 'other'
-  // selects the unattributed (NULL) bucket; an unknown code returns zero totals.
-  clientId: z.string().trim().min(1).optional()
-});
-const LeaderboardSortBy = z.enum([
-  "trades",
-  "totalNetPnl",
-  "volume",
-  "roi"
-]);
-const LEADERBOARD_MAX_LIMIT = 200;
-const UnixSeconds = z.coerce.number().int().min(0).transform((seconds) => new Date(seconds * 1e3));
-const ConnectorArray = z.preprocess((arg) => normalizeArray(arg), z.array(Connector));
-const AssetArray = z.preprocess((arg) => normalizeArray(arg), z.array(z.string().trim().min(1)));
-const LeaderboardQueryParams = z.object({
-  // Attribution filter, not a scope boundary — any caller may pass any client.
-  clientId: z.string().optional(),
-  // Absent means every connector. The filter applies before the top-N cut, so
-  // two connectors return the top N across both combined, not N of each.
-  connector: ConnectorArray.optional(),
-  // Absent means every asset. Filtering is per-leg: a long-BTC / short-ETH basket
-  // contributes only its BTC leg to an asset=BTC board. Each asset's realized-PnL
-  // walk is independent, so selecting a subset leaves every remaining walk complete.
-  asset: AssetArray.optional(),
-  sortBy: LeaderboardSortBy.default("totalNetPnl"),
-  // Inclusive, and it scopes the money without scoping the trading. Volume and totalTrades
-  // count every fill inside the window, whatever period its position began in. Realized
-  // PnL, unrealized PnL, the fees behind them and roi count only for a position whose
-  // opening fill lands at or after this, so an exit is never booked — nor its fee charged —
-  // against an entry the window never saw. Volume is therefore additive across two adjacent
-  // windows and PnL is not, and a row can report volume beside no fees at all.
-  startDate: UnixSeconds.optional(),
-  // Exclusive. Unrealized PnL is included whenever the window still contains now — an
-  // absent endDate, or one that has not yet arrived. Only a window that has already closed
-  // is settled and reproducible, and only there is unrealized PnL omitted: it is a value as
-  // of now, and now is outside such a window.
-  endDate: UnixSeconds.optional(),
-  // Whether an account whose owner linked no X account may hold a row. Off by default,
-  // because a trader who has not linked X does not qualify for the campaign the board
-  // feeds. Eligibility turns on linking, so admission does too: a trader who linked X
-  // and then withheld the handle keeps their rank and loses only their name.
-  // The gate is on the account, not on the viewer: it applies before the top-N cut, so
-  // it selects who makes the board rather than thinning the rows that came back, and
-  // every caller is served exactly the same board.
-  //
-  // Deliberately not `z.coerce.boolean()`, which reads the string "false" as true and
-  // would leave the default impossible to restore explicitly from a URL.
-  includeUnlinkedX: z.union([
-    z.boolean(),
-    z.stringbool()
-  ]).optional().default(false),
-  limit: z.coerce.number().int().positive().max(LEADERBOARD_MAX_LIMIT).default(LEADERBOARD_MAX_LIMIT)
-}).refine((data) => !data.startDate || !data.endDate || data.startDate < data.endDate, {
-  message: "startDate must be before endDate"
-});
-const LeaderboardSnapshotParams = z.object({
-  slug: z.string()
-});
-const LeaderboardSnapshotQueryParams = z.object({
-  // Absent means the default the board was published with, never the registry's current one.
-  sortBy: LeaderboardSortBy.optional(),
-  // Defaults to the free-form board's 200, so a migrating client sees no change. Deliberately
-  // uncapped, unlike LEADERBOARD_MAX_LIMIT there: the snapshot already holds every qualifying
-  // row, so a larger limit costs response size, not a ranking.
-  limit: z.coerce.number().int().positive().default(200)
-});
-const LeaderboardArchiveParams = z.object({
-  slug: z.string()
-});
-const LeaderboardArchivePeriodParams = z.object({
-  slug: z.string(),
-  startDate: UnixSeconds
-});
-
-export { LEADERBOARD_MAX_LIMIT, LeaderboardArchiveParams, LeaderboardArchivePeriodParams, LeaderboardQueryParams, LeaderboardSnapshotParams, LeaderboardSnapshotQueryParams, LeaderboardSortBy, OiStatisticsQueryParams, StatisticsTotalsQueryParams, VolumeStatisticsQueryParams };

package/dist/statistics/responses.js

@@ -1,67 +0,0 @@
-import { z } from 'zod';
-import { LeaderboardRow, VolumeStatistics, OiStatistics, StatisticsTotals } from './entities';
-import { LeaderboardSortBy } from './queries';
-
-const LeaderboardResponse = z.object({
-  data: z.array(LeaderboardRow)
-});
-const UnixSeconds = z.number().int().nonnegative();
-const LeaderboardStatus = z.enum([
-  "upcoming",
-  "live",
-  "final"
-]);
-const LeaderboardSnapshotResponse = z.object({
-  // Echoes the path parameter.
-  slug: z.string(),
-  // Lifecycle of the requested competition; final rows come from its frozen archive.
-  status: LeaderboardStatus,
-  // The order the rows are in, including when the board's published default was applied.
-  sortBy: LeaderboardSortBy,
-  // Live: computed at; final: archived at; upcoming: lifecycle evaluated at.
-  updatedAt: z.iso.datetime(),
-  // The period the rows cover, in the free-form board's query units, so a consumer can feed
-  // these back as its startDate/endDate to reproduce the board. An absent bound is open.
-  window: z.object({
-    startDate: UnixSeconds.optional(),
-    endDate: UnixSeconds.optional()
-  }),
-  data: z.array(LeaderboardRow)
-});
-const LeaderboardArchiveListResponse = z.object({
-  // Echoes the path parameter.
-  slug: z.string(),
-  periods: z.array(z.object({
-    // The period's bounds in the free-form board's query units; startDate addresses the period.
-    startDate: UnixSeconds,
-    endDate: UnixSeconds,
-    // When the period was ranked — not a freshness signal, the board never changes after it.
-    archivedAt: z.iso.datetime()
-  }))
-});
-const LeaderboardArchiveResponse = z.object({
-  // Echoes the path parameter.
-  slug: z.string(),
-  // The order the rows are in, including when the archived query's default was applied.
-  sortBy: LeaderboardSortBy,
-  // A finished period always has both bounds, in the free-form board's query units, so a
-  // consumer can feed them back as its startDate/endDate to re-query the period.
-  window: z.object({
-    startDate: UnixSeconds,
-    endDate: UnixSeconds
-  }),
-  // When the period was ranked; distinct from a live board's updatedAt, it says nothing of freshness.
-  archivedAt: z.iso.datetime(),
-  data: z.array(LeaderboardRow)
-});
-const VolumeStatisticsResponse = z.object({
-  data: z.array(VolumeStatistics)
-});
-const OiStatisticsResponse = z.object({
-  data: z.array(OiStatistics)
-});
-const StatisticsTotalsResponse = z.object({
-  data: StatisticsTotals
-});
-
-export { LeaderboardArchiveListResponse, LeaderboardArchiveResponse, LeaderboardResponse, LeaderboardSnapshotResponse, LeaderboardStatus, OiStatisticsResponse, StatisticsTotalsResponse, VolumeStatisticsResponse };

package/dist/sync/index.js

@@ -1,2 +0,0 @@
-export * from './payloads';
-export * from './responses';

package/dist/sync/payloads.js

@@ -1,136 +0,0 @@
-import { z } from 'zod';
-import { UnsignedDecimalString, DecimalString, Side, SignedDecimalString } from '../common/schema';
-import { Connector } from '../connector';
-import { InstrumentId } from '../instrument';
-import { PositionClosedReason, PositionStatus, PositionOrigin } from '../position/entities';
-
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-const ExchangeFillId = z.string().trim().min(1, "Exchange fill ID must be non-empty");
-const MsTimestamp = z.number().int().positive().describe("Unix timestamp in milliseconds");
-const LiquidationMark = z.object({
-  mark: UnsignedDecimalString
-}).nullable();
-const TradeFee = DecimalString;
-const OriginalFillRef = z.object({
-  exchangeFillId: ExchangeFillId,
-  quantity: UnsignedDecimalString
-});
-const UnknownExternalFill = z.object({
-  exchangeFillId: ExchangeFillId,
-  cloid: z.string().nullable(),
-  connector: Connector,
-  symbol: InstrumentId,
-  price: UnsignedDecimalString,
-  quantity: UnsignedDecimalString,
-  side: Side,
-  reduceOnly: z.boolean(),
-  timestamp: MsTimestamp,
-  tradeFee: TradeFee,
-  builderFee: UnsignedDecimalString,
-  liquidation: LiquidationMark
-});
-const SyncFillsSinceRequest = z.object({
-  overlapMs: z.number().int().positive()
-});
-const SyncFundingSinceRequest = z.object({
-  overlapMs: z.number().int().positive()
-});
-const ExternalPosition = z.object({
-  symbol: InstrumentId,
-  size: UnsignedDecimalString.describe("BASE units, contractSize applied; always >= 0"),
-  side: Side.describe("sign of the net position"),
-  entryPrice: UnsignedDecimalString.describe("exchange-reported average entry"),
-  markPrice: UnsignedDecimalString
-});
-const ApplicableFill = z.object({
-  // Deterministic synthetic id (`synthetic-{positionKey}-{symbol}-{side}`) for synthetic fills,
-  // exchange-native id for real fills.
-  exchangeFillId: ExchangeFillId,
-  cloid: z.string().nullable(),
-  connector: Connector,
-  symbol: InstrumentId,
-  side: Side,
-  quantity: UnsignedDecimalString.describe("BASE units"),
-  price: UnsignedDecimalString.describe('"0" only on an unpriceable gone-close synthetic'),
-  usd: UnsignedDecimalString.describe('"0" only on an unpriceable gone-close synthetic'),
-  timestamp: MsTimestamp.describe("ms \u2014 apply replays in this order"),
-  reduceOnly: z.boolean(),
-  synthetic: z.boolean(),
-  isExternal: z.boolean(),
-  tradeFee: TradeFee,
-  builderFee: UnsignedDecimalString,
-  closedReason: PositionClosedReason.optional().describe("e.g. NETTED for a synthetic close fill"),
-  liquidation: LiquidationMark.unwrap().extend({
-    outcome: z.enum([
-      "CLOSED",
-      "REDUCED"
-    ]).optional().describe("Position outcome after this reducing slice")
-  }).nullable().optional(),
-  original: OriginalFillRef.optional()
-});
-const ApplicableMetadata = z.object({
-  initialExposureUSD: z.record(InstrumentId, SignedDecimalString).describe("opening cost basis from this position\u2019s own real fills; partial map allowed")
-});
-const ApplicablePosition = z.object({
-  positionKey: z.string().trim().min(1, "positionKey must be non-empty"),
-  exposure: z.record(InstrumentId, SignedDecimalString).describe("final position exposure (signed, BASE units)"),
-  origin: PositionOrigin,
-  status: PositionStatus,
-  closedReason: PositionClosedReason.optional().describe("set when status is CLOSED, e.g. NETTED"),
-  fills: z.array(ApplicableFill).min(1, "Applicable must carry at least one fill"),
-  metadata: ApplicableMetadata
-});
-const WATERMARK_FUTURE_SKEW_MS = 3e5;
-const SyncMeta = z.object({
-  externalMaxTs: z.number().int().nonnegative().refine((timestamp) => timestamp <= Date.now() + WATERMARK_FUTURE_SKEW_MS, "externalMaxTs must not be ahead of server time").nullable().describe("watermark advance source")
-});
-const CreateApplicablesMeta = SyncMeta.extend({
-  firstSyncStartedAt: z.number().int().nonnegative().optional().describe("backend-issued timestamp returned before the first fill-history fetch"),
-  newestFillTs: z.number().int().nonnegative().refine((timestamp) => timestamp <= Date.now() + WATERMARK_FUTURE_SKEW_MS, "newestFillTs must not be ahead of server time").optional().describe("raw newest fetched fill \u2014 settle-gate source, never trim-advanced; present exactly when externalMaxTs is"),
-  executionsUpdatedAtEpochMs: z.number().int().nonnegative().describe("verbatim echo of fills/since executionsUpdatedAtEpochMs \u2014 stale-read gate token, not a client clock")
-}).superRefine(refineNewestFillTsPairsWithWatermark);
-const CreateApplicablesBulkFields = z.object({
-  executionsUpdatedAtEpochMs: z.string().regex(/^\d+$/, "Must be a non-negative integer millisecond value").transform(Number).describe("mirror of meta.executionsUpdatedAtEpochMs, readable without decompressing the payload")
-});
-const CreateApplicablesRequest = z.object({
-  applicables: z.array(ApplicablePosition),
-  exchangePositions: z.array(ExternalPosition),
-  meta: CreateApplicablesMeta
-});
-const OptionallySignedDecimalString = z.string().regex(/^[+-]?\d+(\.\d+)?$/, "Must be a valid signed decimal string");
-const FundingPaymentEntry = z.object({
-  connector: Connector,
-  instrumentId: InstrumentId,
-  fundingRate: OptionallySignedDecimalString.describe("applied funding rate, optionally signed"),
-  notional: OptionallySignedDecimalString.describe("funding amount in USD notional, optionally signed"),
-  fundingPerUnit: OptionallySignedDecimalString.describe("signed funding per 1 unit of size (notional / szi); attribution coefficient"),
-  timestamp: MsTimestamp
-});
-const CreateFundingPaymentsRequest = z.object({
-  payments: z.array(FundingPaymentEntry),
-  meta: SyncMeta
-});
-function refineNewestFillTsPairsWithWatermark(meta, ctx) {
-  if (meta.externalMaxTs !== null && meta.newestFillTs === void 0) {
-    ctx.addIssue({
-      code: "custom",
-      message: "newestFillTs is required when externalMaxTs is set",
-      path: [
-        "newestFillTs"
-      ]
-    });
-  }
-  if (meta.externalMaxTs === null && meta.newestFillTs !== void 0) {
-    ctx.addIssue({
-      code: "custom",
-      message: "newestFillTs must be absent when externalMaxTs is null",
-      path: [
-        "newestFillTs"
-      ]
-    });
-  }
-}
-__name(refineNewestFillTsPairsWithWatermark, "refineNewestFillTsPairsWithWatermark");
-
-export { ApplicableFill, ApplicableMetadata, ApplicablePosition, CreateApplicablesBulkFields, CreateApplicablesMeta, CreateApplicablesRequest, CreateFundingPaymentsRequest, ExternalPosition, FundingPaymentEntry, SyncFillsSinceRequest, SyncFundingSinceRequest, SyncMeta, UnknownExternalFill, WATERMARK_FUTURE_SKEW_MS };

package/dist/sync/responses.js

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-
-const SyncFillsResponse = z.object({});
-const SyncFillsSinceResponse = z.object({
-  sinceMs: z.number().int().nonnegative(),
-  // True only when the account has no checkpoint and nothing to anchor on, so sync starts from
-  // genesis. Clients use this to detect an account that has never imported its trade history —
-  // `sinceMs === 0` alone is ambiguous (a clamped watermark also yields 0).
-  neverSynced: z.boolean(),
-  // Backend-clock boundary returned only for a never-synced account. The syncer carries this
-  // through when an empty exchange fetch provides no fill-derived checkpoint.
-  firstSyncStartedAt: z.number().int().nonnegative().optional(),
-  confirmedExchangeFillIds: z.array(z.string()).optional(),
-  // A pending correction needs the next full snapshot even when there are no fills to apply.
-  hasPendingSynthetics: z.boolean().optional(),
-  // Newest executions.updatedAt this response can have observed, as epoch ms ceiled to the next
-  // whole millisecond (the column keeps microseconds); 0 when the account has no executions. The
-  // client echoes it verbatim in the create meta — core defers the create when any execution
-  // write postdates it. No client clock on the wire: ordering is against our own persisted
-  // updated_at values (Postgres now() on insert, the engine's clock on updates — the settle
-  // gate covers skew between those writers).
-  executionsUpdatedAtEpochMs: z.number().int().nonnegative()
-});
-const SyncFundingSinceResponse = z.object({
-  sinceMs: z.number().int().nonnegative()
-});
-
-export { SyncFillsResponse, SyncFillsSinceResponse, SyncFundingSinceResponse };

package/dist/tca/entities.js

@@ -1,9 +0,0 @@
-import { z } from 'zod';
-
-const TcaMetricStatus = z.literal("FINAL");
-const TcaTimingGranularity = z.enum([
-  "BATCH",
-  "LEG"
-]);
-
-export { TcaMetricStatus, TcaTimingGranularity };

package/dist/tca/index.js

@@ -1,3 +0,0 @@
-export * from './entities';
-export * from './queries';
-export * from './responses';

package/dist/tca/queries.js

@@ -1,14 +0,0 @@
-import { z } from 'zod';
-
-const TcaPositionQueryParams = z.object({
-  limit: z.coerce.number().int().positive().max(2e3).optional().default(100),
-  cursor: z.iso.datetime().optional()
-});
-const TcaSummaryQueryParams = z.object({
-  limit: z.coerce.number().int().positive().max(2e3).optional().default(100),
-  cursor: z.iso.datetime().optional(),
-  from: z.iso.datetime().optional(),
-  to: z.iso.datetime().optional()
-});
-
-export { TcaPositionQueryParams, TcaSummaryQueryParams };

package/dist/tca/responses.js

@@ -1,126 +0,0 @@
-import { z } from 'zod';
-import { Side } from '../common/schema';
-import { Connector } from '../connector';
-import { ExecutionStatus, ExecutionOrderType, ExecutionIntent } from '../execution/entities';
-import { TcaMetricStatus, TcaTimingGranularity } from './entities';
-
-const optionalNumeric = z.string().optional();
-const optionalTimestamp = z.iso.datetime().optional();
-const TcaBenchmarkResponse = z.object({
-  id: z.uuid(),
-  executionId: z.uuid(),
-  orderId: z.uuid().optional(),
-  cloid: z.string().optional(),
-  legIndex: z.number(),
-  connector: Connector,
-  symbol: z.string(),
-  side: z.enum([
-    "BUY",
-    "SELL"
-  ]),
-  decisionPrice: optionalNumeric,
-  arrivalMid: optionalNumeric,
-  arrivalBid: optionalNumeric,
-  arrivalAsk: optionalNumeric,
-  markPrice: optionalNumeric,
-  indexPrice: optionalNumeric,
-  source: z.string(),
-  timestamp: z.iso.datetime(),
-  quoteAsset: z.string().optional(),
-  usdConversionPrice: optionalNumeric,
-  createdAt: z.iso.datetime()
-});
-const TcaFillMetricResponse = z.object({
-  id: z.uuid(),
-  fillId: z.uuid(),
-  benchmarkId: z.uuid().optional(),
-  executionId: z.uuid().optional(),
-  positionId: z.uuid().optional(),
-  tradeAccountId: z.uuid(),
-  connector: Connector,
-  symbol: z.string(),
-  cloid: z.string().optional(),
-  exchangeFillId: z.string().optional(),
-  slippageBps: optionalNumeric,
-  slippageQuote: optionalNumeric,
-  slippageUsd: optionalNumeric,
-  implementationShortfallBps: optionalNumeric,
-  spreadCostQuote: optionalNumeric,
-  spreadCostUsd: optionalNumeric,
-  tradeFee: optionalNumeric,
-  pearFee: optionalNumeric,
-  totalCostUsd: optionalNumeric,
-  gatewayLatencyMs: z.number().optional(),
-  timeToFillMs: z.number().optional(),
-  quoteAsset: z.string().optional(),
-  notionalQuote: optionalNumeric,
-  notionalUsd: optionalNumeric,
-  submittedAt: optionalTimestamp,
-  acknowledgedAt: optionalTimestamp,
-  exchangeExecutedAt: optionalTimestamp,
-  timingGranularity: TcaTimingGranularity.optional(),
-  status: TcaMetricStatus,
-  createdAt: z.iso.datetime(),
-  updatedAt: z.iso.datetime(),
-  benchmark: TcaBenchmarkResponse.optional()
-});
-const TcaExecutionSummaryLegResponse = z.object({
-  symbol: z.string(),
-  side: Side,
-  reduceOnly: z.boolean()
-});
-const TcaExecutionSummaryContextResponse = z.object({
-  intent: ExecutionIntent,
-  orderType: ExecutionOrderType,
-  executionStatus: ExecutionStatus,
-  positionId: z.uuid().optional(),
-  scheduleId: z.uuid().optional(),
-  triggerId: z.uuid().optional(),
-  legs: z.array(TcaExecutionSummaryLegResponse)
-});
-const TcaExecutionSummaryResponse = z.object({
-  id: z.uuid(),
-  executionId: z.uuid(),
-  tradeAccountId: z.uuid(),
-  connector: Connector,
-  executionContext: TcaExecutionSummaryContextResponse.optional(),
-  notionalQuote: optionalNumeric,
-  notionalUsd: optionalNumeric,
-  weightedSlippageBps: optionalNumeric,
-  totalSlippageUsd: optionalNumeric,
-  totalTradeFee: optionalNumeric,
-  totalPearFee: optionalNumeric,
-  totalCostUsd: optionalNumeric,
-  fillCount: z.number(),
-  status: TcaMetricStatus,
-  createdAt: z.iso.datetime(),
-  updatedAt: z.iso.datetime()
-});
-const TcaExecutionResponse = z.object({
-  summary: TcaExecutionSummaryResponse.optional(),
-  fillMetrics: z.array(TcaFillMetricResponse)
-});
-const TcaPositionResponse = z.object({
-  limit: z.number(),
-  nextCursor: z.iso.datetime().optional(),
-  fillMetrics: z.array(TcaFillMetricResponse)
-});
-const TcaSummaryTotalsResponse = z.object({
-  executionCount: z.number(),
-  fillCount: z.number(),
-  notionalQuote: optionalNumeric,
-  notionalUsd: optionalNumeric,
-  weightedSlippageBps: optionalNumeric,
-  totalSlippageUsd: optionalNumeric,
-  totalTradeFee: optionalNumeric,
-  totalPearFee: optionalNumeric,
-  totalCostUsd: optionalNumeric
-});
-const TcaSummaryResponse = z.object({
-  limit: z.number(),
-  nextCursor: z.iso.datetime().optional(),
-  summaries: z.array(TcaExecutionSummaryResponse),
-  totals: TcaSummaryTotalsResponse
-});
-
-export { TcaBenchmarkResponse, TcaExecutionResponse, TcaExecutionSummaryContextResponse, TcaExecutionSummaryLegResponse, TcaExecutionSummaryResponse, TcaFillMetricResponse, TcaPositionResponse, TcaSummaryResponse, TcaSummaryTotalsResponse };