@uniswap/client-data-api 0.0.176 → 0.0.178

package/dist/data/v2/api_pb.d.ts

@@ -562,6 +562,21 @@ export declare class GetTokenTradesRequest extends Message<GetTokenTradesRequest
      * @generated from field: optional string wallet = 3;
      */
     wallet?: string;
+    /**
+     * Minimum trade size: keep only trades whose amount_usd is >= this
+     * threshold. Trades with no known USD amount are excluded when set (they
+     * cannot be proven to clear the bar). Omitted or 0 = no filtering; negative
+     * or non-finite values are rejected. Applied before the page cut, so a page
+     * holds up to page_size MATCHING trades — but the server bounds how far it
+     * scans per request, so a page may come back short of page_size while
+     * next_page_token is still set; presence of next_page_token, not page
+     * fullness, signals more data under this filter. Like wallet, page_token
+     * carries only a keyset position — the client must resend the same
+     * min_amount_usd on every page.
+     *
+     * @generated from field: optional double min_amount_usd = 4;
+     */
+    minAmountUsd?: number;
     constructor(data?: PartialMessage<GetTokenTradesRequest>);
     static readonly runtime: typeof proto3;
     static readonly typeName = "data.v2.GetTokenTradesRequest";
@@ -1753,8 +1768,9 @@ export declare class GetTokenTopTradersRequest extends Message<GetTokenTopTrader
  * flags transferred_in.
  *
  * UNKNOWN-BASIS ROWS: when the server cannot compute a wallet's basis — the
- * wallet transferred tokens in (transferred_in), or its auction spend was
- * not USD-convertible — basis_unknown is true and the four basis-derived
+ * wallet transferred tokens in (transferred_in), its auction spend was not
+ * USD-convertible, or its attributed inventory contradicts its observed
+ * balance — basis_unknown is true and the four basis-derived
  * money fields (cost_basis_usd, avg_cost_usd, realized_pnl_usd,
  * unrealized_pnl_usd) are served as 0 and MUST be read as "unknown", never
  * as a real $0.00. Such wallets rank strictly after every computable-PnL
@@ -1806,8 +1822,12 @@ export declare class TokenTopTrader extends Message<TokenTopTrader> {
      */
     soldTokens: number;
     /**
-     * Tokens still held per the walk: acquired (bought + claimed +
-     * transferred in) minus sold, floored at 0.
+     * Tokens still held. For launch tokens this is the wallet's OBSERVED net
+     * balance — the same sum over transfer logs GetLaunchHolders serves, so
+     * the two agree and Σ over wallets cannot exceed supply. Tokens outside
+     * that feed fall back to the swap walk (acquired minus sold, floored at
+     * 0), an attribution that can overstate a wallet signing swaps it does
+     * not receive (relayers, bundlers, smart-account signers).
      *
      * @generated from field: double remaining_tokens = 8;
      */
@@ -1821,8 +1841,9 @@ export declare class TokenTopTrader extends Message<TokenTopTrader> {
      */
     costBasisUsd: number;
     /**
-     * cost_basis_usd ÷ remaining_tokens; 0 for wallets holding nothing.
-     * Meaningless (served 0) when basis_unknown.
+     * cost_basis_usd ÷ the TRACKED quantity the basis was accumulated over
+     * (bought + claimed − sold), which is not necessarily remaining_tokens; 0
+     * when nothing is tracked. Meaningless (served 0) when basis_unknown.
      *
      * @generated from field: double avg_cost_usd = 10;
      */
@@ -1851,7 +1872,7 @@ export declare class TokenTopTrader extends Message<TokenTopTrader> {
     hasClaims: boolean;
     /**
      * Mark-to-market PnL of the remaining position at the token's latest
-     * known price: remaining_tokens × (spot − avg_cost_usd). The documented
+     * known price: remaining_tokens × spot − cost_basis_usd. The documented
      * ranking tiebreak, served so clients can render it. Meaningless (served
      * 0) when unrealized_pnl_unknown — basis unknown, or no known spot price.
      *
@@ -1868,8 +1889,11 @@ export declare class TokenTopTrader extends Message<TokenTopTrader> {
     transferredIn: boolean;
     /**
      * True when the wallet's basis could not be computed — it transferred
-     * tokens in (transferred_in), or its auction spend was not
-     * USD-convertible. Clients should render the four basis-derived money
+     * tokens in (transferred_in), its auction spend was not USD-convertible,
+     * or its attributed inventory contradicts its observed balance (the
+     * acquisitions were booked to the wrong address, so the basis they
+     * produced is not this wallet's). Clients should render the four
+     * basis-derived money
      * fields as unknown ("–"), not $0.00; the row ranks after every
      * computable-PnL row (see message doc). Implies unrealized_pnl_unknown.
      *

package/dist/data/v2/api_pb.js

@@ -683,6 +683,7 @@ GetTokenTradesRequest.fields = proto3.util.newFieldList(() => [
     { no: 1, name: "token", kind: "message", T: TokenIdentifier },
     { no: 2, name: "page", kind: "message", T: PageRequest, opt: true },
     { no: 3, name: "wallet", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
+    { no: 4, name: "min_amount_usd", kind: "scalar", T: 1 /* ScalarType.DOUBLE */, opt: true },
 ]);
 /**
  * @generated from message data.v2.GetTokenTradesResponse
@@ -2155,8 +2156,9 @@ GetTokenTopTradersRequest.fields = proto3.util.newFieldList(() => [
  * flags transferred_in.
  *
  * UNKNOWN-BASIS ROWS: when the server cannot compute a wallet's basis — the
- * wallet transferred tokens in (transferred_in), or its auction spend was
- * not USD-convertible — basis_unknown is true and the four basis-derived
+ * wallet transferred tokens in (transferred_in), its auction spend was not
+ * USD-convertible, or its attributed inventory contradicts its observed
+ * balance — basis_unknown is true and the four basis-derived
  * money fields (cost_basis_usd, avg_cost_usd, realized_pnl_usd,
  * unrealized_pnl_usd) are served as 0 and MUST be read as "unknown", never
  * as a real $0.00. Such wallets rank strictly after every computable-PnL
@@ -2210,8 +2212,12 @@ export class TokenTopTrader extends Message {
          */
         this.soldTokens = 0;
         /**
-         * Tokens still held per the walk: acquired (bought + claimed +
-         * transferred in) minus sold, floored at 0.
+         * Tokens still held. For launch tokens this is the wallet's OBSERVED net
+         * balance — the same sum over transfer logs GetLaunchHolders serves, so
+         * the two agree and Σ over wallets cannot exceed supply. Tokens outside
+         * that feed fall back to the swap walk (acquired minus sold, floored at
+         * 0), an attribution that can overstate a wallet signing swaps it does
+         * not receive (relayers, bundlers, smart-account signers).
          *
          * @generated from field: double remaining_tokens = 8;
          */
@@ -2225,8 +2231,9 @@ export class TokenTopTrader extends Message {
          */
         this.costBasisUsd = 0;
         /**
-         * cost_basis_usd ÷ remaining_tokens; 0 for wallets holding nothing.
-         * Meaningless (served 0) when basis_unknown.
+         * cost_basis_usd ÷ the TRACKED quantity the basis was accumulated over
+         * (bought + claimed − sold), which is not necessarily remaining_tokens; 0
+         * when nothing is tracked. Meaningless (served 0) when basis_unknown.
          *
          * @generated from field: double avg_cost_usd = 10;
          */
@@ -2255,7 +2262,7 @@ export class TokenTopTrader extends Message {
         this.hasClaims = false;
         /**
          * Mark-to-market PnL of the remaining position at the token's latest
-         * known price: remaining_tokens × (spot − avg_cost_usd). The documented
+         * known price: remaining_tokens × spot − cost_basis_usd. The documented
          * ranking tiebreak, served so clients can render it. Meaningless (served
          * 0) when unrealized_pnl_unknown — basis unknown, or no known spot price.
          *
@@ -2272,8 +2279,11 @@ export class TokenTopTrader extends Message {
         this.transferredIn = false;
         /**
          * True when the wallet's basis could not be computed — it transferred
-         * tokens in (transferred_in), or its auction spend was not
-         * USD-convertible. Clients should render the four basis-derived money
+         * tokens in (transferred_in), its auction spend was not USD-convertible,
+         * or its attributed inventory contradicts its observed balance (the
+         * acquisitions were booked to the wrong address, so the basis they
+         * produced is not this wallet's). Clients should render the four
+         * basis-derived money
          * fields as unknown ("–"), not $0.00; the row ranks after every
          * computable-PnL row (see message doc). Implies unrealized_pnl_unknown.
          *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@uniswap/client-data-api",
-    "version": "0.0.176",
+    "version": "0.0.178",
     "publishConfig": {
       "access": "public"
     },