@codex-data/sdk 2.4.11 → 2.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -8231,6 +8231,8 @@ export type PredictionEventFilterResult = {
8231
8231
  liquidityUsd?: Maybe<Scalars['String']['output']>;
8232
8232
  /** Data for marketCount. */
8233
8233
  marketCount: Scalars['Int']['output'];
8234
+ /** The number of the event's markets in each status; the counts add up to marketCount. Null for events not reindexed since this field was added. */
8235
+ marketCounts?: Maybe<PredictionEventMarketCounts>;
8234
8236
  /** Data for markets. */
8235
8237
  markets: Array<PredictionEventFilterResultMarket>;
8236
8238
  /** Open interest in collateral token units. */
@@ -8555,6 +8557,20 @@ export type PredictionEventFilters = {
8555
8557
  /** Volume in USD. */
8556
8558
  volumeUsdAll?: InputMaybe<NumberFilter>;
8557
8559
  };
8560
+ /** The number of a prediction event's markets in each market status. */
8561
+ export type PredictionEventMarketCounts = {
8562
+ __typename?: 'PredictionEventMarketCounts';
8563
+ /** Markets that were invalidated. Not derived today, so always 0. */
8564
+ cancelled: Scalars['Int']['output'];
8565
+ /** Markets accepting trades. */
8566
+ open: Scalars['Int']['output'];
8567
+ /** Markets that have not opened yet. */
8568
+ pending: Scalars['Int']['output'];
8569
+ /** Markets whose outcome is determined or that are closed. */
8570
+ resolved: Scalars['Int']['output'];
8571
+ /** Markets with trading temporarily halted. Not derived today, so always 0. */
8572
+ suspended: Scalars['Int']['output'];
8573
+ };
8558
8574
  /** Deprecated. Sort order for markets within a prediction event. This no longer affects market ordering. */
8559
8575
  export declare enum PredictionEventMarketSort {
8560
8576
  /**
@@ -12318,6 +12334,8 @@ export type Query = {
12318
12334
  tokens: Array<Maybe<EnhancedToken>>;
12319
12335
  /** Returns the percentage of a token's total supply held collectively by its top 10 holders. */
12320
12336
  top10HoldersPercent?: Maybe<Scalars['Float']['output']>;
12337
+ /** Returns the compute units charged for the request that carries this field, so you can see what a query costs before you run it at volume. Add it to any query; the field itself is free. `total` is the whole request; `items` lists each priced component. When the whole request was free (every root field errored), all values are zero. */
12338
+ usageData: UsageData;
12321
12339
  /** Once a wallet backfill has been triggered, this query can be used to check the status of the backfill. */
12322
12340
  walletAggregateBackfillState: WalletAggregateBackfillStateResponse;
12323
12341
  /** Returns a chart of a wallet's activity. */
@@ -14308,9 +14326,9 @@ export type TokenFilterResult = {
14308
14326
  builderTips12?: Maybe<Scalars['String']['output']>;
14309
14327
  /** The total builder tips (MEV) in USD in the past 24 hours. */
14310
14328
  builderTips24?: Maybe<Scalars['String']['output']>;
14311
- /** The number of wallets that have bundled the token */
14329
+ /** The number of wallets that have bundled the token. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones. */
14312
14330
  bundlerCount?: Maybe<Scalars['Int']['output']>;
14313
- /** The percentage of tokens held by bundlers */
14331
+ /** The percentage of tokens held by bundlers. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones. */
14314
14332
  bundlerHeldPercentage?: Maybe<Scalars['Float']['output']>;
14315
14333
  /** The number of buys in the past hour. */
14316
14334
  buyCount1?: Maybe<Scalars['Int']['output']>;
@@ -14346,7 +14364,7 @@ export type TokenFilterResult = {
14346
14364
  circulatingMarketCap?: Maybe<Scalars['String']['output']>;
14347
14365
  /** The unix timestamp for the creation of the token's first pair. */
14348
14366
  createdAt?: Maybe<Scalars['Int']['output']>;
14349
- /** The percentage of tokens held by the dev */
14367
+ /** The percentage of tokens held by the dev. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones. */
14350
14368
  devHeldPercentage?: Maybe<Scalars['Float']['output']>;
14351
14369
  /** The exchanges the token is listed on. */
14352
14370
  exchanges?: Maybe<Array<Maybe<Exchange>>>;
@@ -14374,9 +14392,9 @@ export type TokenFilterResult = {
14374
14392
  high24?: Maybe<Scalars['String']['output']>;
14375
14393
  /** The number of different wallets holding the token. */
14376
14394
  holders?: Maybe<Scalars['Int']['output']>;
14377
- /** The number of wallets that have been an insider of the token */
14395
+ /** The number of wallets that have been an insider of the token. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones. */
14378
14396
  insiderCount?: Maybe<Scalars['Int']['output']>;
14379
- /** The percentage of tokens held by insiders */
14397
+ /** The percentage of tokens held by insiders. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones. */
14380
14398
  insiderHeldPercentage?: Maybe<Scalars['Float']['output']>;
14381
14399
  /** Whether the token has been flagged as a scam. */
14382
14400
  isScam?: Maybe<Scalars['Boolean']['output']>;
@@ -14460,13 +14478,13 @@ export type TokenFilterResult = {
14460
14478
  sellVolume12?: Maybe<Scalars['String']['output']>;
14461
14479
  /** The sell volume in USD in the past 24 hours. */
14462
14480
  sellVolume24?: Maybe<Scalars['String']['output']>;
14463
- /** The number of wallets that have sniped the token */
14481
+ /** The number of wallets that have sniped the token. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones. */
14464
14482
  sniperCount?: Maybe<Scalars['Int']['output']>;
14465
- /** The percentage of tokens held by snipers */
14483
+ /** The percentage of tokens held by snipers. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones. */
14466
14484
  sniperHeldPercentage?: Maybe<Scalars['Float']['output']>;
14467
- /** The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders) */
14485
+ /** The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders). Null for a token without a launchpad; `tokenWalletStats` serves EVM ones. */
14468
14486
  suspiciousCount?: Maybe<Scalars['Int']['output']>;
14469
- /** The percentage of tokens held by suspicious wallets */
14487
+ /** The percentage of tokens held by suspicious wallets. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones. */
14470
14488
  suspiciousHeldPercentage?: Maybe<Scalars['Float']['output']>;
14471
14489
  /** The percentage of wallets that are less than 1d old that have traded in the last 24h */
14472
14490
  swapPct1dOldWallet?: Maybe<Scalars['String']['output']>;
@@ -14575,9 +14593,9 @@ export type TokenFilters = {
14575
14593
  bluechipRatings?: InputMaybe<Array<Scalars['String']['input']>>;
14576
14594
  /** Recursive boolean expression for combining token filters. */
14577
14595
  boolFilter?: InputMaybe<TokenBoolFilter>;
14578
- /** Filter by number of wallets that have bundled the token */
14596
+ /** Filter by number of wallets that have bundled the token. Covers launchpad tokens only; any other token never matches. */
14579
14597
  bundlerCount?: InputMaybe<NumberFilter>;
14580
- /** Filter by percentage of tokens held by bundlers */
14598
+ /** Filter by percentage of tokens held by bundlers. Covers launchpad tokens only; any other token never matches. */
14581
14599
  bundlerHeldPercentage?: InputMaybe<NumberFilter>;
14582
14600
  /** The number of buys in the past hour. */
14583
14601
  buyCount1?: InputMaybe<NumberFilter>;
@@ -14629,7 +14647,7 @@ export type TokenFilters = {
14629
14647
  creatorAddress?: InputMaybe<Scalars['String']['input']>;
14630
14648
  /** The addresses of the token creators (supports multiple addresses). Max 25 addresses. You cannot provide both creatorAddress and creatorAddresses. */
14631
14649
  creatorAddresses?: InputMaybe<Array<Scalars['String']['input']>>;
14632
- /** Filter by percentage of tokens held by the dev */
14650
+ /** Filter by percentage of tokens held by the dev. Covers launchpad tokens only; any other token never matches. */
14633
14651
  devHeldPercentage?: InputMaybe<NumberFilter>;
14634
14652
  /** The list of exchange contract addresses to filter by. */
14635
14653
  exchangeAddress?: InputMaybe<Array<InputMaybe<Scalars['String']['input']>>>;
@@ -14657,9 +14675,9 @@ export type TokenFilters = {
14657
14675
  holders?: InputMaybe<NumberFilter>;
14658
14676
  /** Whether to include tokens that have been flagged as scams. Default: false */
14659
14677
  includeScams?: InputMaybe<Scalars['Boolean']['input']>;
14660
- /** Filter by number of wallets that have been an insider of the token */
14678
+ /** Filter by number of wallets that have been an insider of the token. Covers launchpad tokens only; any other token never matches. */
14661
14679
  insiderCount?: InputMaybe<NumberFilter>;
14662
- /** Filter by percentage of tokens held by insiders */
14680
+ /** Filter by percentage of tokens held by insiders. Covers launchpad tokens only; any other token never matches. */
14663
14681
  insiderHeldPercentage?: InputMaybe<NumberFilter>;
14664
14682
  /** Whether to filter for tokens on testnet networks. Use `true` for testnet tokens only, `false` for mainnet tokens only and `undefined` (default) for both. */
14665
14683
  isTestnet?: InputMaybe<Scalars['Boolean']['input']>;
@@ -14739,15 +14757,15 @@ export type TokenFilters = {
14739
14757
  sellVolume12?: InputMaybe<NumberFilter>;
14740
14758
  /** The sell volume in USD in the past 24 hours. */
14741
14759
  sellVolume24?: InputMaybe<NumberFilter>;
14742
- /** Filter by number of wallets that have sniped the token */
14760
+ /** Filter by number of wallets that have sniped the token. Covers launchpad tokens only; any other token never matches. */
14743
14761
  sniperCount?: InputMaybe<NumberFilter>;
14744
- /** Filter by percentage of tokens held by snipers */
14762
+ /** Filter by percentage of tokens held by snipers. Covers launchpad tokens only; any other token never matches. */
14745
14763
  sniperHeldPercentage?: InputMaybe<NumberFilter>;
14746
14764
  /** Filter by the token's social links (contributed or provider-sourced). Grid organization links are not counted. */
14747
14765
  socials?: InputMaybe<TokenSocialFilter>;
14748
- /** Filter by number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders) */
14766
+ /** Filter by number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders). Covers launchpad tokens only; any other token never matches. */
14749
14767
  suspiciousCount?: InputMaybe<NumberFilter>;
14750
- /** Filter by percentage of tokens held by suspicious wallets */
14768
+ /** Filter by percentage of tokens held by suspicious wallets. Covers launchpad tokens only; any other token never matches. */
14751
14769
  suspiciousHeldPercentage?: InputMaybe<NumberFilter>;
14752
14770
  /** The percentage of wallets that are less than 1d old that have traded in the last 24h. */
14753
14771
  swapPct1dOldWallet?: InputMaybe<NumberFilter>;
@@ -15590,17 +15608,19 @@ export type TokenWalletFilterResult = {
15590
15608
  /** Registry entity ids of the apps this wallet trades through — e.g. `defined` for defined.fi, or `axiom`. A property of the WALLET, not of its activity on this token: a wallet that trades most tokens through one app and this one through another lists both. Means "trades through", never "is owned by". */
15591
15609
  walletTradeSourceIds?: Maybe<Array<Scalars['String']['output']>>;
15592
15610
  };
15593
- /** The sniper, bundler and insider wallets that still hold a token. Counts, amounts and addresses cover current holders only: a labelled wallet that has sold its whole balance is left out, so every figure falls as those wallets sell. Available for launchpad tokens on every network, and for EVM tokens without a launchpad that have a known creator and were created since 2025-10-08. Other tokens return zeros. */
15611
+ /** The sniper, bundler and insider wallets that still hold a token. Counts, amounts and addresses cover current holders only: a labelled wallet that has sold its whole balance is left out, so every figure falls as those wallets sell. Each label reads at most 1,000 holders; past that, its count reads 1,000 and its amount and percentage cover those holders only. Available for launchpad tokens on every network, and for EVM tokens without a launchpad that have a known creator and were created since 2025-10-08. Read `covered` first: for any other token it is false, and every figure is 0 because nothing was measured. */
15594
15612
  export type TokenWalletStats = {
15595
15613
  __typename?: 'TokenWalletStats';
15596
15614
  /** The bundler wallets that hold this token. Limited to 200. */
15597
15615
  bundlerAddresses: Array<Scalars['String']['output']>;
15598
- /** The number of bundler wallets that hold this token. A bundler is one of 4 or more wallets that bought the token in the same block at launch. */
15616
+ /** The number of bundler wallets that hold this token. A bundler is one of 4 or more wallets that bought the token in the same block while it was on its launchpad, or in its first hour when it has none. A wallet one sender bought a large share for, alongside other wallets in the same block, is a bundler too. */
15599
15617
  bundlerCount: Scalars['Int']['output'];
15600
15618
  /** The amount of the token held by bundler wallets, unshifted. */
15601
15619
  bundlerHeldAmount: Scalars['String']['output'];
15602
15620
  /** The percentage of token supply held by bundler wallets. */
15603
15621
  bundlerHeldPercentage: Scalars['Float']['output'];
15622
+ /** Whether Codex tracks snipers, bundlers and insiders for this token. When false, every count and percentage is 0 because nothing was measured, not because none were found. */
15623
+ covered: Scalars['Boolean']['output'];
15604
15624
  /** The developer/creator wallet. Empty when the creator is unknown. */
15605
15625
  devAddress: Scalars['String']['output'];
15606
15626
  /** The amount of the token held by the developer/creator wallet, unshifted. */
@@ -15609,7 +15629,7 @@ export type TokenWalletStats = {
15609
15629
  devHeldPercentage: Scalars['Float']['output'];
15610
15630
  /** The insider wallets that hold this token. Limited to 200. */
15611
15631
  insiderAddresses: Array<Scalars['String']['output']>;
15612
- /** The number of insider wallets that hold this token. An insider received the token through a link to its creator rather than by buying it on the open market. */
15632
+ /** The number of insider wallets that hold this token. An insider got the token through a link to its creator rather than by buying it on the open market: it bought in the creation transaction, received the token from the creator, or was first funded by the creator. On Solana, a wallet seeded with the token in its first minutes without buying it is an insider too. */
15613
15633
  insiderCount: Scalars['Int']['output'];
15614
15634
  /** The amount of the token held by insider wallets, unshifted. */
15615
15635
  insiderHeldAmount: Scalars['String']['output'];
@@ -15619,7 +15639,7 @@ export type TokenWalletStats = {
15619
15639
  networkId: Scalars['Int']['output'];
15620
15640
  /** The sniper wallets that hold this token. Limited to 200. */
15621
15641
  sniperAddresses: Array<Scalars['String']['output']>;
15622
- /** The number of sniper wallets that hold this token. A sniper bought within the first 5 seconds of trading. */
15642
+ /** The number of sniper wallets that hold this token. A sniper bought within the first 5 seconds of trading. The creator's own buy at launch counts. */
15623
15643
  sniperCount: Scalars['Int']['output'];
15624
15644
  /** The amount of the token held by sniper wallets, unshifted. */
15625
15645
  sniperHeldAmount: Scalars['String']['output'];
@@ -15900,6 +15920,36 @@ export type UniswapV4Data = {
15900
15920
  /** The address of the hook contract for Uniswap V4 pools. */
15901
15921
  uniswapV4HookAddress?: Maybe<Scalars['String']['output']>;
15902
15922
  };
15923
+ /** Response returned by `usageData`: the compute units charged for the request that carried the field. */
15924
+ export type UsageData = {
15925
+ __typename?: 'UsageData';
15926
+ /** Each priced component of the request: one entry per operation, per-object type, or priced field. */
15927
+ items: Array<UsageDataItem>;
15928
+ /** Totals across all items. */
15929
+ total: UsageDataMetrics;
15930
+ };
15931
+ /** One priced component of a request. */
15932
+ export type UsageDataItem = {
15933
+ __typename?: 'UsageDataItem';
15934
+ /** For a per-object cost, the type of the objects counted (for example `EnhancedToken`). Null for operation and field costs. */
15935
+ entityType?: Maybe<Scalars['String']['output']>;
15936
+ /** The metrics charged for this component. */
15937
+ metrics: UsageDataMetrics;
15938
+ /** The operation or field that was priced, for example `filterTokens` or `filterTokens.results.token`. */
15939
+ resource: Scalars['String']['output'];
15940
+ };
15941
+ /** Usage metrics for one priced component, or for the whole request. Values are integers returned as strings. */
15942
+ export type UsageDataMetrics = {
15943
+ __typename?: 'UsageDataMetrics';
15944
+ /** Response bytes measured for this component. Reported for reference; standard pricing does not bill it. */
15945
+ bytes: Scalars['String']['output'];
15946
+ /** Compute units charged, with six decimals of precision: 1,000,000 = 1 CU. */
15947
+ computeUnits: Scalars['String']['output'];
15948
+ /** Billable units, not requests: 1 per call of a priced field, or the number of objects returned for a per-object cost. */
15949
+ count: Scalars['String']['output'];
15950
+ /** Processing time in milliseconds measured for this component. Reported for reference; standard pricing does not bill it. */
15951
+ durationMs: Scalars['String']['output'];
15952
+ };
15903
15953
  export type Wallet = {
15904
15954
  __typename?: 'Wallet';
15905
15955
  address: Scalars['String']['output'];
@@ -31879,6 +31929,14 @@ export type FilterPredictionEventsQuery = {
31879
31929
  venueSeriesId?: string | null;
31880
31930
  venueUrl: string;
31881
31931
  };
31932
+ marketCounts?: {
31933
+ __typename?: 'PredictionEventMarketCounts';
31934
+ cancelled: number;
31935
+ open: number;
31936
+ pending: number;
31937
+ resolved: number;
31938
+ suspended: number;
31939
+ } | null;
31882
31940
  markets: Array<{
31883
31941
  __typename?: 'PredictionEventFilterResultMarket';
31884
31942
  id: string;
@@ -59387,6 +59445,7 @@ export type TokenWalletStatsQuery = {
59387
59445
  bundlerCount: number;
59388
59446
  bundlerHeldAmount: string;
59389
59447
  bundlerHeldPercentage: number;
59448
+ covered: boolean;
59390
59449
  devAddress: string;
59391
59450
  devHeldAmount: string;
59392
59451
  devHeldPercentage: number;
@@ -60639,6 +60698,34 @@ export type Top10HoldersPercentQuery = {
60639
60698
  __typename?: 'Query';
60640
60699
  top10HoldersPercent?: number | null;
60641
60700
  };
60701
+ export type UsageDataQueryVariables = Exact<{
60702
+ [key: string]: never;
60703
+ }>;
60704
+ export type UsageDataQuery = {
60705
+ __typename?: 'Query';
60706
+ usageData: {
60707
+ __typename?: 'UsageData';
60708
+ items: Array<{
60709
+ __typename?: 'UsageDataItem';
60710
+ entityType?: string | null;
60711
+ resource: string;
60712
+ metrics: {
60713
+ __typename?: 'UsageDataMetrics';
60714
+ bytes: string;
60715
+ computeUnits: string;
60716
+ count: string;
60717
+ durationMs: string;
60718
+ };
60719
+ }>;
60720
+ total: {
60721
+ __typename?: 'UsageDataMetrics';
60722
+ bytes: string;
60723
+ computeUnits: string;
60724
+ count: string;
60725
+ durationMs: string;
60726
+ };
60727
+ };
60728
+ };
60642
60729
  export type WalletAggregateBackfillStateQueryVariables = Exact<{
60643
60730
  input: WalletAggregateBackfillStateInput;
60644
60731
  }>;
@@ -80271,6 +80358,7 @@ export declare const TokenTopTradersDocument: DocumentNode<TokenTopTradersQuery,
80271
80358
  export declare const TokenWalletStatsDocument: DocumentNode<TokenWalletStatsQuery, TokenWalletStatsQueryVariables>;
80272
80359
  export declare const TokensDocument: DocumentNode<TokensQuery, TokensQueryVariables>;
80273
80360
  export declare const Top10HoldersPercentDocument: DocumentNode<Top10HoldersPercentQuery, Top10HoldersPercentQueryVariables>;
80361
+ export declare const UsageDataDocument: DocumentNode<UsageDataQuery, UsageDataQueryVariables>;
80274
80362
  export declare const WalletAggregateBackfillStateDocument: DocumentNode<WalletAggregateBackfillStateQuery, WalletAggregateBackfillStateQueryVariables>;
80275
80363
  export declare const WalletChartDocument: DocumentNode<WalletChartQuery, WalletChartQueryVariables>;
80276
80364
  export declare const WalletLabelTypesDocument: DocumentNode<WalletLabelTypesQuery, WalletLabelTypesQueryVariables>;