@codex-data/sdk 2.3.42 → 2.4.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.
package/schema.graphql CHANGED
@@ -288,12 +288,12 @@ type Query {
288
288
  walletNftCollectionAssets(
289
289
  input: WalletNftCollectionAssetsInput!
290
290
  ): WalletNftCollectionAssetsResponse! @deprecated(reason: "NFT data coverage will be removed on March 31, 2026")
291
- """Returns the full vocabulary of wallet label types and their metadata."""
292
- walletLabelTypes: [WalletLabelType!]!
293
- """Returns community gathered notes."""
294
- getCommunityNotes(
295
- input: CommunityNotesInput
296
- ): CommunityNotesResponse!
291
+ """Get all active short-lived api tokens for this api key"""
292
+ apiTokens: [ApiToken!]!
293
+ """Get the active short-lived api token for this api key by the short-lived token"""
294
+ apiToken(
295
+ token: String!
296
+ ): ApiToken!
297
297
  """Returns windowed and all-time stats for a prediction market."""
298
298
  detailedPredictionMarketStats(
299
299
  """Input parameters used to select a market and stat windows."""
@@ -472,12 +472,12 @@ type Query {
472
472
  """Where in the list the server should start when returning items."""
473
473
  offset: Int
474
474
  ): PredictionTraderFilterConnection
475
- """Get all active short-lived api tokens for this api key"""
476
- apiTokens: [ApiToken!]!
477
- """Get the active short-lived api token for this api key by the short-lived token"""
478
- apiToken(
479
- token: String!
480
- ): ApiToken!
475
+ """Returns the full vocabulary of wallet label types and their metadata."""
476
+ walletLabelTypes: [WalletLabelType!]!
477
+ """Returns community gathered notes."""
478
+ getCommunityNotes(
479
+ input: CommunityNotesInput
480
+ ): CommunityNotesResponse!
481
481
  """Returns block data for the input blockNumbers or timestamps, maximum 25 inputs."""
482
482
  blocks(
483
483
  input: BlocksInput!
@@ -603,7 +603,7 @@ type Query {
603
603
  filterLaunchpads(
604
604
  """A set of filters to apply."""
605
605
  filters: LaunchpadFilters
606
- """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, pons, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, UniswapCCA, tren.ch, StonkFun."""
606
+ """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel."""
607
607
  launchpads: [String!]
608
608
  """A list of network IDs to include. If not provided, all networks are considered."""
609
609
  networks: [Int!]
@@ -846,6 +846,19 @@ type Query {
846
846
  holders(
847
847
  input: HoldersInput!
848
848
  ): HoldersResponse!
849
+ """Returns recorded token analyses, including pending and failed requests. Results are ordered by block number descending, then request timestamp descending. Use simulationId to retrieve a specific request."""
850
+ getSimulateTokenContractResults(
851
+ """The token contract address."""
852
+ contractAddress: String!
853
+ """The network ID of the token."""
854
+ networkId: Int!
855
+ """Optional request ID returned by simulateTokenContract; restricts results to that request."""
856
+ simulationId: String
857
+ """Opaque cursor from the preceding response."""
858
+ cursor: String
859
+ """Maximum number of records per page. Defaults to 10 when omitted."""
860
+ limit: Int
861
+ ): GetSimulateTokenContractResultsConnection!
849
862
  """Returns a list of latest tokens."""
850
863
  getLatestTokens(
851
864
  """The maximum number of tokens to return. Maximum number of tokens is 50."""
@@ -865,7 +878,18 @@ type Query {
865
878
  networkId: Int!
866
879
  """A cursor for use in pagination."""
867
880
  cursor: String
868
- ): LiquidityLockConnection
881
+ ): LiquidityLockConnection @deprecated(reason: "Event-derived and retiring with the legacy lock pipeline. Use liquidityLocksV2.")
882
+ """Returns locked liquidity for a pair or token, read from current on-chain state. Vesting is matured at read time, so an expired lock stops counting."""
883
+ liquidityLocksV2(
884
+ """The address of the pair."""
885
+ pairAddress: String
886
+ """The address of the token."""
887
+ tokenAddress: String
888
+ """The network id of the pair."""
889
+ networkId: Int!
890
+ """A cursor for use in pagination."""
891
+ cursor: String
892
+ ): LiquidityLockV2Connection
869
893
  """Returns liquidity metadata for a given pair. Includes liquidity lock data."""
870
894
  liquidityMetadata(
871
895
  """The address of the pair."""
@@ -908,6 +932,10 @@ type Query {
908
932
  walletChart(
909
933
  input: WalletChartInput!
910
934
  ): WalletChartResponse
935
+ """Returns the sniper, bundler and insider wallets that still hold a token, and how much of the supply they hold."""
936
+ tokenWalletStats(
937
+ input: TokenWalletStatsInput!
938
+ ): TokenWalletStats!
911
939
  }
912
940
 
913
941
  type Mutation {
@@ -929,6 +957,10 @@ type Mutation {
929
957
  """input: Input for deleting webhooks."""
930
958
  input: DeleteWebhooksInput!
931
959
  ): DeleteWebhooksOutput
960
+ """Queues asynchronous token analysis. Use simulateLiveContractInput; legacy deployment and creation-transaction modes are not supported by the current analyzer. A successful response acknowledges submission, not a trading verdict. Retrieve the outcome with getSimulateTokenContractResults. Non-admin requests have a five-minute cooldown per token and network; a cooldown violation raises TOO_MANY_REQUESTS."""
961
+ simulateTokenContract(
962
+ input: SimulateTokenContractInput!
963
+ ): SimulateTokenContractResponse
932
964
  """Force refreshes the balance for a token in a wallet, persisting the result so subsequent `balances` queries reflect it. Supports contract tokens (`<tokenAddress>:<networkId>`, EVM only) and native token balances (`native:<networkId>`, EVM, Solana, and Starknet). Entries that cannot be refreshed (e.g. an unreachable network) are omitted from the response rather than erroring."""
933
965
  refreshBalances(
934
966
  input: [RefreshBalancesInput!]!
@@ -997,7 +1029,7 @@ type Subscription {
997
1029
  onBarsUpdated(
998
1030
  """The ID of the pair (`address`:`networkId`)."""
999
1031
  pairId: String
1000
- """The commitment levels to subscribe to."""
1032
+ """The commitment levels to subscribe to. Preprocessed is deprecated because edge node performance improvements have made it unnecessary. Use Processed instead."""
1001
1033
  commitmentLevel: [BarCommitmentLevel!]
1002
1034
  """The token of interest within the pair. Can be `token0` or `token1`."""
1003
1035
  quoteToken: QuoteToken
@@ -1013,7 +1045,7 @@ type Subscription {
1013
1045
  onTokenBarsUpdated(
1014
1046
  """The ID of the token (`address`:`networkId`). Required unless you are on an enterprise plan including BarFeed features."""
1015
1047
  tokenId: String
1016
- """The commitment levels to subscribe to."""
1048
+ """The commitment levels to subscribe to. Preprocessed is deprecated because edge node performance improvements have made it unnecessary. Use Processed instead."""
1017
1049
  commitmentLevel: [BarCommitmentLevel!]
1018
1050
  """The networkId to use when getting all bars per network."""
1019
1051
  networkId: Int
@@ -1024,7 +1056,7 @@ type Subscription {
1024
1056
  address: String
1025
1057
  """The ID of the pair (`address`:`networkId`). Required unless you are on an enterprise plan including EventFeed features."""
1026
1058
  id: String
1027
- """The commitment levels to subscribe to. When multiple commitment levels are subscribed to, events are emitted at most once per increasing commitment stage per subscriber. If a stronger commitment level is observed first, later weaker updates for the same event are suppressed for a short in-memory window. Preprocessed is supported only for Solana event subscriptions. Preprocessed evaluates pre-execution events and can differ significantly from processed or confirmed output. In particular, preprocessed swaps may use aggregator swaps before it is known how execution will route the underlying swaps, and many preprocessed events may error and never be processed."""
1059
+ """The commitment levels to subscribe to. When multiple commitment levels are subscribed to, events are emitted at most once per increasing commitment stage per subscriber. If a stronger commitment level is observed first, later weaker updates for the same event are suppressed for a short in-memory window. Preprocessed is deprecated because edge node performance improvements have made it unnecessary. Use Processed instead. Preprocessed is supported only for Solana event subscriptions. Preprocessed evaluates pre-execution events and can differ significantly from processed or confirmed output. In particular, preprocessed swaps may use aggregator swaps before it is known how execution will route the underlying swaps, and many preprocessed events may error and never be processed."""
1028
1060
  commitmentLevel: [EventCommitmentLevel!]
1029
1061
  """The token of interest within the pair. Can be `token0` or `token1`."""
1030
1062
  quoteToken: QuoteToken
@@ -1034,7 +1066,7 @@ type Subscription {
1034
1066
  """Live-streamed transactions for a maker."""
1035
1067
  onEventsCreatedByMaker(
1036
1068
  input: OnEventsCreatedByMakerInput!
1037
- """The commitment levels to subscribe to. When multiple commitment levels are subscribed to, events are emitted at most once per increasing commitment stage per subscriber. If a stronger commitment level is observed first, later weaker updates for the same event are suppressed for a short in-memory window. Preprocessed is supported only for Solana event subscriptions. Preprocessed evaluates pre-execution events and can differ significantly from processed or confirmed output. In particular, preprocessed swaps may use aggregator swaps before it is known how execution will route the underlying swaps, and many preprocessed events may error and never be processed."""
1069
+ """The commitment levels to subscribe to. When multiple commitment levels are subscribed to, events are emitted at most once per increasing commitment stage per subscriber. If a stronger commitment level is observed first, later weaker updates for the same event are suppressed for a short in-memory window. Preprocessed is deprecated because edge node performance improvements have made it unnecessary. Use Processed instead. Preprocessed is supported only for Solana event subscriptions. Preprocessed evaluates pre-execution events and can differ significantly from processed or confirmed output. In particular, preprocessed swaps may use aggregator swaps before it is known how execution will route the underlying swaps, and many preprocessed events may error and never be processed."""
1038
1070
  commitmentLevel: [EventCommitmentLevel!]
1039
1071
  ): AddEventsByMakerOutput
1040
1072
  """Deprecated unconfirmed live-streamed transactions for a token. Use `onEventsCreated` instead. (Solana only)"""
@@ -1085,8 +1117,10 @@ type Subscription {
1085
1117
  ): DetailedStats
1086
1118
  """Live-streamed bucketed stats for a given token."""
1087
1119
  onDetailedTokenStatsUpdated(
1088
- """The ID of the token (`address`:`networkId`)."""
1120
+ """The ID of the token (`address`:`networkId`). Required unless you are on an enterprise plan including TokenStatsFeed features."""
1089
1121
  tokenId: String
1122
+ """The network ID to stream stats for every token on. Used only when `tokenId` is omitted."""
1123
+ networkId: Int
1090
1124
  ): DetailedTokenStats
1091
1125
  """Live-streamed filter token updates for the current `filterTokens` result set."""
1092
1126
  onFilterTokensUpdated(
@@ -1125,15 +1159,27 @@ type Subscription {
1125
1159
  """The ID of the pair (`address`:`networkId`)."""
1126
1160
  id: String
1127
1161
  ): EventLabel
1162
+ """Live-streamed published analysis results for a token, across all simulation IDs. This is not a complete request-status stream: use getSimulateTokenContractResults to check pending, failed or indeterminate outcomes."""
1163
+ onSimulateTokenContract(
1164
+ """Required by the resolver, despite being nullable in the schema. The token contract address to monitor."""
1165
+ contractAddress: String
1166
+ """The network ID of the token."""
1167
+ networkId: Int!
1168
+ """Currently ignored. Filter received results by uuid on the client, or query getSimulateTokenContractResults with this ID."""
1169
+ simulationId: String
1170
+ ): SimulateTokenContractResult!
1128
1171
  """Live-streamed events for a given token across all it's pools"""
1129
1172
  onTokenEventsCreated(
1130
1173
  input: OnTokenEventsCreatedInput!
1131
- """The commitment levels to subscribe to. When multiple commitment levels are subscribed to, events are emitted at most once per increasing commitment stage per subscriber. If a stronger commitment level is observed first, later weaker updates for the same event are suppressed for a short in-memory window. Preprocessed is supported only for Solana event subscriptions. Preprocessed evaluates pre-execution events and can differ significantly from processed or confirmed output. In particular, preprocessed swaps may use aggregator swaps before it is known how execution will route the underlying swaps, and many preprocessed events may error and never be processed."""
1174
+ """The commitment levels to subscribe to. When multiple commitment levels are subscribed to, events are emitted at most once per increasing commitment stage per subscriber. If a stronger commitment level is observed first, later weaker updates for the same event are suppressed for a short in-memory window. Preprocessed is deprecated because edge node performance improvements have made it unnecessary. Use Processed instead. Preprocessed is supported only for Solana event subscriptions. Preprocessed evaluates pre-execution events and can differ significantly from processed or confirmed output. In particular, preprocessed swaps may use aggregator swaps before it is known how execution will route the underlying swaps, and many preprocessed events may error and never be processed."""
1132
1175
  commitmentLevel: [EventCommitmentLevel!]
1133
1176
  ): AddTokenEventsOutput!
1134
1177
  """Live-streamed list of wallets that hold a given token. Also has the unique count of holders for that token."""
1135
1178
  onHoldersUpdated(
1136
- tokenId: String!
1179
+ """The ID of the token (`address`:`networkId`). Required unless you are on an enterprise plan including BalanceFeed features."""
1180
+ tokenId: String
1181
+ """The network ID to stream holder updates for every token on. Used only when `tokenId` is omitted."""
1182
+ networkId: Int
1137
1183
  ): HoldersUpdate
1138
1184
  """Live-streamed balance updates for a given wallet."""
1139
1185
  onBalanceUpdated(
@@ -4675,707 +4721,64 @@ type AddNftPoolEventsOutput {
4675
4721
 
4676
4722
  scalar JSON
4677
4723
 
4678
- scalar Void
4724
+ type ApiToken {
4725
+ """Unique identifier for the token"""
4726
+ id: String!
4727
+ """JWT to be passed into the Authorization header for API requests"""
4728
+ token: String!
4729
+ """ISO time string for the expiry of the token"""
4730
+ expiresTimeString: String!
4731
+ """Number of root fields this api token is allowed to resolve before it's rate limited"""
4732
+ requestLimit: String!
4733
+ """Approximate number of remaining resolutions before this token is rate limited"""
4734
+ remaining: String
4735
+ }
4679
4736
 
4680
- """Type of the community gathered note."""
4681
- enum CommunityNoteType {
4682
- """An contract attribute change."""
4683
- ATTRIBUTE
4684
- """A scam report."""
4685
- SCAM
4686
- """A logo change."""
4687
- LOGO
4737
+ input CreateApiTokensInput {
4738
+ """Number of tokens to create, default is 1"""
4739
+ count: Int
4740
+ """Number of requests allowed per token, represented as a string, default is 5000"""
4741
+ requestLimit: String
4742
+ """Number of milliseconds until the token expires, defaults to 1 hour (3600000)"""
4743
+ expiresIn: Int
4688
4744
  }
4689
4745
 
4690
- """Type of the contract."""
4691
- enum ContractType {
4692
- TOKEN
4693
- WALLET
4746
+ """A prediction sub-subcategory (3rd level, terminal)."""
4747
+ type PredictionSubSubcategory {
4748
+ """The display name."""
4749
+ name: String!
4750
+ """The URL slug."""
4751
+ slug: String!
4694
4752
  }
4695
4753
 
4696
- enum ContractProposalStatus {
4697
- ACCEPTED
4698
- PENDING
4699
- REJECTED
4700
- REVERTED
4754
+ """A prediction subcategory (2nd level)."""
4755
+ type PredictionSubcategory {
4756
+ """The display name."""
4757
+ name: String!
4758
+ """The URL slug."""
4759
+ slug: String!
4760
+ """Nested subcategories (3rd level)."""
4761
+ subcategories: [PredictionSubSubcategory!]
4701
4762
  }
4702
4763
 
4703
- """The attribute used to rank tokens."""
4704
- enum TokenRankingAttribute {
4705
- createdAt
4706
- tokenCreatedAt
4707
- lastTransaction
4708
- age @deprecated(reason: "Use createdAt instead")
4709
- buyCount5m
4710
- buyCount1
4711
- buyCount4
4712
- buyCount12
4713
- buyCount24
4714
- change5m
4715
- change1
4716
- change4
4717
- change12
4718
- change24
4719
- volumeChange5m
4720
- volumeChange1
4721
- volumeChange4
4722
- volumeChange12
4723
- volumeChange24
4724
- high5m
4725
- high1
4726
- high4
4727
- high12
4728
- high24
4729
- holders
4730
- notableHolderCount
4731
- liquidity
4732
- totalLiquidityUsd
4733
- low5m
4734
- low1
4735
- low4
4736
- low12
4737
- low24
4738
- marketCap
4739
- circulatingMarketCap
4740
- priceUSD
4741
- sellCount5m
4742
- sellCount1
4743
- sellCount4
4744
- sellCount12
4745
- sellCount24
4746
- trendingScore
4747
- trendingScore5m
4748
- trendingScore1
4749
- trendingScore4
4750
- trendingScore12
4751
- trendingScore24
4752
- txnCount5m
4753
- txnCount1
4754
- txnCount4
4755
- txnCount12
4756
- txnCount24
4757
- uniqueBuys5m
4758
- uniqueBuys1
4759
- uniqueBuys4
4760
- uniqueBuys12
4761
- uniqueBuys24
4762
- uniqueSells5m
4763
- uniqueSells1
4764
- uniqueSells4
4765
- uniqueSells12
4766
- uniqueSells24
4767
- uniqueTransactions5m
4768
- uniqueTransactions1
4769
- uniqueTransactions4
4770
- uniqueTransactions12
4771
- uniqueTransactions24
4772
- volume5m
4773
- volume1
4774
- volume4
4775
- volume12
4776
- volume24
4777
- buyVolume5m
4778
- buyVolume1
4779
- buyVolume4
4780
- buyVolume12
4781
- buyVolume24
4782
- sellVolume5m
4783
- sellVolume1
4784
- sellVolume4
4785
- sellVolume12
4786
- sellVolume24
4787
- poolFees5m
4788
- poolFees1
4789
- poolFees4
4790
- poolFees12
4791
- poolFees24
4792
- baseFees5m
4793
- baseFees1
4794
- baseFees4
4795
- baseFees12
4796
- baseFees24
4797
- priorityFees5m
4798
- priorityFees1
4799
- priorityFees4
4800
- priorityFees12
4801
- priorityFees24
4802
- builderTips5m
4803
- builderTips1
4804
- builderTips4
4805
- builderTips12
4806
- builderTips24
4807
- l1DataFees5m
4808
- l1DataFees1
4809
- l1DataFees4
4810
- l1DataFees12
4811
- l1DataFees24
4812
- totalFees5m
4813
- totalFees1
4814
- totalFees4
4815
- totalFees12
4816
- totalFees24
4817
- feeToVolumeRatio5m
4818
- feeToVolumeRatio1
4819
- feeToVolumeRatio4
4820
- feeToVolumeRatio12
4821
- feeToVolumeRatio24
4822
- launchpadCompletedAt
4823
- launchpadMigratedAt
4824
- graduationPercent
4825
- walletAgeAvg
4826
- walletAgeStd
4827
- swapPct1dOldWallet
4828
- swapPct7dOldWallet
4829
- sniperHeldPercentage
4830
- bundlerHeldPercentage
4831
- insiderHeldPercentage
4832
- suspiciousHeldPercentage
4833
- sniperCount
4834
- bundlerCount
4835
- insiderCount
4836
- suspiciousCount
4837
- devHeldPercentage
4838
- top10HoldersPercent
4839
- coinCommunityPostCount
4840
- coinCommunityMemberCount
4841
- coinCommunityLikeCount
4842
- coinCommunityLastPostAt
4764
+ """A prediction category with optional nested subcategories."""
4765
+ type PredictionCategory {
4766
+ """The display name."""
4767
+ name: String!
4768
+ """The URL slug."""
4769
+ slug: String!
4770
+ """Nested subcategories (2nd level)."""
4771
+ subcategories: [PredictionSubcategory!]
4843
4772
  }
4844
4773
 
4845
- """Input type of `TokenRanking`."""
4846
- input TokenRanking {
4847
- """The attribute to rank tokens by."""
4848
- attribute: TokenRankingAttribute
4849
- """The direction to apply to the ranking attribute."""
4850
- direction: RankingDirection
4851
- }
4852
-
4853
- """Real-time or historical prices for a token."""
4854
- type Price {
4855
- """The contract address of the token."""
4856
- address: String!
4857
- """The unix timestamp for the price."""
4858
- timestamp: Int
4859
- """The network ID the token is deployed on."""
4860
- networkId: Int!
4861
- """The token price in USD."""
4862
- priceUsd: Float!
4863
- """The pool that emitted the swap generating this price"""
4864
- blockNumber: Int
4865
- """The token's cumulative route-backed liquidity in USD, summed across the token's pairs with valid routing liquidity. Null when this stat has not been computed for the token yet. Not available via subscription."""
4866
- liquidityUsd: String
4867
- """The percent price change in the past 24 hours. Decimal format. Not available via subscription."""
4868
- priceChange24: Float
4869
- """The pool that emitted the swap generating this price"""
4870
- poolAddress: String @deprecated(reason: "Pricing no longer based on specific pools")
4871
- """Ratio of how confident we are in the price"""
4872
- confidence: Float @deprecated(reason: "Pricing no longer based on specific pools")
4873
- }
4874
-
4875
- """Metadata for a token."""
4876
- type EnhancedToken {
4877
- """The ID of the token (`address:networkId`)."""
4878
- id: String!
4879
- """The contract address of the token."""
4880
- address: String!
4881
- """The token ID on CoinMarketCap."""
4882
- cmcId: Int
4883
- """The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals)."""
4884
- decimals: Int!
4885
- """Whether the token has been flagged as a scam."""
4886
- isScam: Boolean
4887
- """The token name. For example, `ApeCoin`."""
4888
- name: String
4889
- """The network ID the token is deployed on."""
4890
- networkId: Int!
4891
- """The token symbol. For example, `APE`."""
4892
- symbol: String
4893
- """The total supply of the token."""
4894
- totalSupply: String @deprecated(reason: "Use the TokenInfo type")
4895
- """Community gathered links for the socials of this token."""
4896
- socialLinks: SocialLinks
4897
- """More metadata about the token."""
4898
- info: TokenInfo
4899
- """The Grid asset ID, if this token is linked to a Grid asset."""
4900
- gridAssetId: String
4901
- """The Grid bluechip rating for this token (e.g. `A+`, `B-`)."""
4902
- bluechipRating: String
4903
- """The Grid organization associated with this token."""
4904
- organization: Organization
4905
- """The Grid asset associated with this token."""
4906
- asset: Asset
4907
- """Information about the token from 3rd party sources."""
4908
- explorerData: ExplorerTokenData @deprecated(reason: "Use the TokenInfo type")
4909
- """A list of exchanges where the token has been traded."""
4910
- exchanges: [Exchange!]
4911
- """The thumbnail token logo URL."""
4912
- imageThumbUrl: String @deprecated(reason: "Use the TokenInfo type")
4913
- """The small token logo URL."""
4914
- imageSmallUrl: String @deprecated(reason: "Use the TokenInfo type")
4915
- """The large token logo URL."""
4916
- imageLargeUrl: String @deprecated(reason: "Use the TokenInfo type")
4917
- """The circulating supply of the token."""
4918
- circulatingSupply: String @deprecated(reason: "Use the TokenInfo type")
4919
- """The amount of this token in the pair."""
4920
- pooled: String @deprecated(reason: "Pooled can be found on the pair instead")
4921
- """The token creator's wallet address."""
4922
- creatorAddress: String
4923
- """The token creator's wallet identity and profile, resolved from creatorAddress. Null when the token has no known creator."""
4924
- creator: Wallet
4925
- """The block height the token was created at."""
4926
- createBlockNumber: Int
4927
- """The transaction hash of the token's creation."""
4928
- createTransactionHash: String
4929
- """The unix timestamp for the creation of the token."""
4930
- createdAt: Int
4931
- """Returns mint authority address if token is mintable. If null, verify against isMintableValid."""
4932
- mintable: String
4933
- """Returns freeze authority address if token is freezable. If null, verify against isFreezableValid."""
4934
- freezable: String
4935
- """Determines if freezable is a valid address or null value for the authority, or if the freezable state has not yet been determined."""
4936
- isFreezableValid: Boolean
4937
- """Determines if mintable is a valid address or null value for the authority, or if the mintable state has not yet been determined."""
4938
- isMintableValid: Boolean
4939
- """The launchpad data for the token, if applicable."""
4940
- launchpad: LaunchpadData
4941
- """The percentage of total supply held by the top 10 holders (excluding exchanges/pairs)."""
4942
- top10HoldersPercent: Float
4943
- """Whether the token name or symbol contains profanity."""
4944
- profanity: Boolean
4945
- """All-time high and low price/market cap data for the token."""
4946
- extrema: TokenExtrema
4947
- """The Coin Community data for the token"""
4948
- coinCommunity: CoinCommunity
4949
- """Token extension metadata, if available."""
4950
- extensions: TokenExtensions
4951
- """Token-standard-specific custom metadata — currently ERC-7572 `contractURI` fields, as used by Base B20 tokens. Null for tokens without a recognized token standard."""
4952
- tokenStandardCustomData: Erc7572CustomInfo
4953
- categories: [Category!]
4954
- }
4955
-
4956
- """A token matching a set of filter parameters."""
4957
- type TokenFilterResult {
4958
- """Metadata for the token."""
4959
- token: EnhancedToken
4960
- """The unix timestamp for the creation of the token's first pair."""
4961
- createdAt: Int
4962
- """The unix timestamp for the token's last transaction."""
4963
- lastTransaction: Int
4964
- age: Int @deprecated(reason: "Age isn't supported - use createdAt instead")
4965
- """The number of buys in the past 5 minutes."""
4966
- buyCount5m: Int
4967
- """The number of buys in the past hour."""
4968
- buyCount1: Int
4969
- """The number of buys in the past 12 hours."""
4970
- buyCount12: Int
4971
- """The number of buys in the past 24 hours."""
4972
- buyCount24: Int
4973
- """The number of buys in the past 4 hours."""
4974
- buyCount4: Int
4975
- """The percent price change in the past 5 minutes. Decimal format."""
4976
- change5m: String
4977
- """The percent price change in the past hour. Decimal format."""
4978
- change1: String
4979
- """The percent price change in the past 12 hours. Decimal format."""
4980
- change12: String
4981
- """The percent price change in the past 24 hours. Decimal format."""
4982
- change24: String
4983
- """The percent price change in the past 4 hours. Decimal format."""
4984
- change4: String
4985
- """The percent volume change in the past 5 minutes. Decimal format."""
4986
- volumeChange5m: String
4987
- """The percent volume change in the past hour. Decimal format."""
4988
- volumeChange1: String
4989
- """The percent volume change in the past 4 hours. Decimal format."""
4990
- volumeChange4: String
4991
- """The percent volume change in the past 12 hours. Decimal format."""
4992
- volumeChange12: String
4993
- """The percent volume change in the past 24 hours. Decimal format."""
4994
- volumeChange24: String
4995
- """The exchanges the token is listed on."""
4996
- exchanges: [Exchange]
4997
- fdv: String @deprecated(reason: "FDV isn't supported - use marketCap instead")
4998
- """The highest price in USD in the past 5 minutes."""
4999
- high5m: String
5000
- """The highest price in USD in the past hour."""
5001
- high1: String
5002
- """The highest price in USD in the past 12 hours."""
5003
- high12: String
5004
- """The highest price in USD in the past 24 hours."""
5005
- high24: String
5006
- """The highest price in USD in the past 4 hours."""
5007
- high4: String
5008
- """Amount of liquidity in the token's top pair."""
5009
- liquidity: String
5010
- """The token's cumulative route-backed liquidity in USD, summed across the token's pairs with valid routing liquidity. Distinct from `liquidity`, which covers the top pair only. Null when this stat has not been computed for the token yet, or when `useAggregatedStats` is not set to `true`."""
5011
- totalLiquidityUsd: String
5012
- """The token of interest. Can be `token0` or `token1`."""
5013
- quoteToken: String
5014
- """The lowest price in USD in the past 5 minutes."""
5015
- low5m: String
5016
- """The lowest price in USD in the past hour."""
5017
- low1: String
5018
- """The lowest price in USD in the past 12 hours."""
5019
- low12: String
5020
- """The lowest price in USD in the past 24 hours."""
5021
- low24: String
5022
- """The lowest price in USD in the past 4 hours."""
5023
- low4: String
5024
- """The fully diluted market cap."""
5025
- marketCap: String
5026
- """The circulating market cap."""
5027
- circulatingMarketCap: String
5028
- """Metadata for the token's top pair."""
5029
- pair: Pair
5030
- """Metadata for the token's most liquid pair"""
5031
- liquidPair: Pair
5032
- """The liquidity of the token's most liquid pair"""
5033
- liquidPairLiquidity: String
5034
- """The liquid pairs price in USD."""
5035
- liquidPairPriceUSD: String
5036
- """The token price in USD."""
5037
- priceUSD: String
5038
- """A heuristic based on various factors used to rank tokens based on how trending they are."""
5039
- trendingScore: Float
5040
- """The number of sells in the past 5 minutes."""
5041
- sellCount5m: Int
5042
- """The number of sells in the past hour."""
5043
- sellCount1: Int
5044
- """The number of sells in the past 12 hours."""
5045
- sellCount12: Int
5046
- """The number of sells in the past 24 hours."""
5047
- sellCount24: Int
5048
- """The number of sells in the past 4 hours."""
5049
- sellCount4: Int
5050
- """The number of transactions in the past 5 minutes."""
5051
- txnCount5m: Int
5052
- """The number of transactions in the past hour."""
5053
- txnCount1: Int
5054
- """The number of transactions in the past 12 hours."""
5055
- txnCount12: Int
5056
- """The number of transactions in the past 24 hours."""
5057
- txnCount24: Int
5058
- """The number of transactions in the past 4 hours."""
5059
- txnCount4: Int
5060
- """The unique number of buys in the past 5 minutes."""
5061
- uniqueBuys5m: Int
5062
- """The unique number of buys in the past hour."""
5063
- uniqueBuys1: Int
5064
- """The unique number of buys in the past 12 hours."""
5065
- uniqueBuys12: Int
5066
- """The unique number of buys in the past 24 hours."""
5067
- uniqueBuys24: Int
5068
- """The unique number of buys in the past 4 hours."""
5069
- uniqueBuys4: Int
5070
- """The unique number of sells in the past 5 minutes."""
5071
- uniqueSells5m: Int
5072
- """The unique number of sells in the past hour."""
5073
- uniqueSells1: Int
5074
- """The unique number of sells in the past 12 hours."""
5075
- uniqueSells12: Int
5076
- """The unique number of sells in the past 24 hours."""
5077
- uniqueSells24: Int
5078
- """The unique number of sells in the past 4 hours."""
5079
- uniqueSells4: Int
5080
- """The unique number of transactions in the past 5 minutes."""
5081
- uniqueTransactions5m: Int
5082
- """The unique number of transactions in the past hour."""
5083
- uniqueTransactions1: Int
5084
- """The unique number of transactions in the past 12 hours."""
5085
- uniqueTransactions12: Int
5086
- """The unique number of transactions in the past 24 hours."""
5087
- uniqueTransactions24: Int
5088
- """The unique number of transactions in the past 4 hours."""
5089
- uniqueTransactions4: Int
5090
- """The trade volume in USD in the past hour."""
5091
- volume1: String
5092
- """The trade volume in USD in the past 5 minutes."""
5093
- volume5m: String
5094
- """The trade volume in USD in the past 12 hours."""
5095
- volume12: String
5096
- """The trade volume in USD in the past 24 hours."""
5097
- volume24: String
5098
- """The trade volume in USD in the past 4 hours."""
5099
- volume4: String
5100
- """The buy volume in USD in the past hour."""
5101
- buyVolume1: String
5102
- """The buy volume in USD in the past 12 hours."""
5103
- buyVolume12: String
5104
- """The buy volume in USD in the past 24 hours."""
5105
- buyVolume24: String
5106
- """The buy volume in USD in the past 4 hours."""
5107
- buyVolume4: String
5108
- """The buy volume in USD in the past 5 minutes."""
5109
- buyVolume5m: String
5110
- """The sell volume in USD in the past hour."""
5111
- sellVolume1: String
5112
- """The sell volume in USD in the past 12 hours."""
5113
- sellVolume12: String
5114
- """The sell volume in USD in the past 24 hours."""
5115
- sellVolume24: String
5116
- """The sell volume in USD in the past 4 hours."""
5117
- sellVolume4: String
5118
- """The sell volume in USD in the past 5 minutes."""
5119
- sellVolume5m: String
5120
- """The total pool fees in USD in the past 5 minutes."""
5121
- poolFees5m: String
5122
- """The total pool fees in USD in the past hour."""
5123
- poolFees1: String
5124
- """The total pool fees in USD in the past 4 hours."""
5125
- poolFees4: String
5126
- """The total pool fees in USD in the past 12 hours."""
5127
- poolFees12: String
5128
- """The total pool fees in USD in the past 24 hours."""
5129
- poolFees24: String
5130
- """The total base gas fees in USD in the past 5 minutes."""
5131
- baseFees5m: String
5132
- """The total base gas fees in USD in the past hour."""
5133
- baseFees1: String
5134
- """The total base gas fees in USD in the past 4 hours."""
5135
- baseFees4: String
5136
- """The total base gas fees in USD in the past 12 hours."""
5137
- baseFees12: String
5138
- """The total base gas fees in USD in the past 24 hours."""
5139
- baseFees24: String
5140
- """The total priority fees in USD in the past 5 minutes."""
5141
- priorityFees5m: String
5142
- """The total priority fees in USD in the past hour."""
5143
- priorityFees1: String
5144
- """The total priority fees in USD in the past 4 hours."""
5145
- priorityFees4: String
5146
- """The total priority fees in USD in the past 12 hours."""
5147
- priorityFees12: String
5148
- """The total priority fees in USD in the past 24 hours."""
5149
- priorityFees24: String
5150
- """The total builder tips (MEV) in USD in the past 5 minutes."""
5151
- builderTips5m: String
5152
- """The total builder tips (MEV) in USD in the past hour."""
5153
- builderTips1: String
5154
- """The total builder tips (MEV) in USD in the past 4 hours."""
5155
- builderTips4: String
5156
- """The total builder tips (MEV) in USD in the past 12 hours."""
5157
- builderTips12: String
5158
- """The total builder tips (MEV) in USD in the past 24 hours."""
5159
- builderTips24: String
5160
- """The total L1 data fees in USD in the past 5 minutes."""
5161
- l1DataFees5m: String
5162
- """The total L1 data fees in USD in the past hour."""
5163
- l1DataFees1: String
5164
- """The total L1 data fees in USD in the past 4 hours."""
5165
- l1DataFees4: String
5166
- """The total L1 data fees in USD in the past 12 hours."""
5167
- l1DataFees12: String
5168
- """The total L1 data fees in USD in the past 24 hours."""
5169
- l1DataFees24: String
5170
- """The total trading fees (pool + gas + tips) in USD in the past 5 minutes."""
5171
- totalFees5m: String
5172
- """The total trading fees (pool + gas + tips) in USD in the past hour."""
5173
- totalFees1: String
5174
- """The total trading fees (pool + gas + tips) in USD in the past 4 hours."""
5175
- totalFees4: String
5176
- """The total trading fees (pool + gas + tips) in USD in the past 12 hours."""
5177
- totalFees12: String
5178
- """The total trading fees (pool + gas + tips) in USD in the past 24 hours."""
5179
- totalFees24: String
5180
- """The ratio of total fees to volume in the past 5 minutes. Decimal format."""
5181
- feeToVolumeRatio5m: String
5182
- """The ratio of total fees to volume in the past hour. Decimal format."""
5183
- feeToVolumeRatio1: String
5184
- """The ratio of total fees to volume in the past 4 hours. Decimal format."""
5185
- feeToVolumeRatio4: String
5186
- """The ratio of total fees to volume in the past 12 hours. Decimal format."""
5187
- feeToVolumeRatio12: String
5188
- """The ratio of total fees to volume in the past 24 hours. Decimal format."""
5189
- feeToVolumeRatio24: String
5190
- """Whether the token has been flagged as a scam."""
5191
- isScam: Boolean
5192
- """The number of different wallets holding the token."""
5193
- holders: Int
5194
- """The average age of the wallets that traded in the last 24h"""
5195
- walletAgeAvg: String
5196
- """The standard deviation of age of the wallets that traded in the last 24h"""
5197
- walletAgeStd: String
5198
- """The percentage of wallets that are less than 1d old that have traded in the last 24h"""
5199
- swapPct1dOldWallet: String
5200
- """The percentage of wallets that are less than 7d old that have traded in the last 24h"""
5201
- swapPct7dOldWallet: String
5202
- """The number of wallets that have sniped the token"""
5203
- sniperCount: Int
5204
- """The percentage of tokens held by snipers"""
5205
- sniperHeldPercentage: Float
5206
- """The number of wallets that have bundled the token"""
5207
- bundlerCount: Int
5208
- """The percentage of tokens held by bundlers"""
5209
- bundlerHeldPercentage: Float
5210
- """The number of wallets that have been an insider of the token"""
5211
- insiderCount: Int
5212
- """The percentage of tokens held by insiders"""
5213
- insiderHeldPercentage: Float
5214
- """The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders)"""
5215
- suspiciousCount: Int
5216
- """The percentage of tokens held by suspicious wallets"""
5217
- suspiciousHeldPercentage: Float
5218
- """The percentage of tokens held by the dev"""
5219
- devHeldPercentage: Float
5220
- """The percentage of total supply held by the top 10 holders."""
5221
- top10HoldersPercent: Float
5222
- """The reasons the token has been flagged as a potential scam."""
5223
- potentialScamReasons: [PotentialScamReason]
5224
- """The all-time high price in USD."""
5225
- athPrice: String
5226
- """The unix timestamp when the all-time high price was reached."""
5227
- athPriceTimestamp: Int
5228
- """The all-time low price in USD."""
5229
- atlPrice: String
5230
- """The unix timestamp when the all-time low price was reached."""
5231
- atlPriceTimestamp: Int
5232
- """The all-time high fully diluted market cap."""
5233
- athFdv: String
5234
- """The unix timestamp when the all-time high FDV was reached."""
5235
- athFdvTimestamp: Int
5236
- """The all-time low fully diluted market cap."""
5237
- atlFdv: String
5238
- """The unix timestamp when the all-time low FDV was reached."""
5239
- atlFdvTimestamp: Int
5240
- """The all-time high circulating market cap."""
5241
- athCircMc: String
5242
- """The unix timestamp when the all-time high circulating market cap was reached."""
5243
- athCircMcTimestamp: Int
5244
- """The all-time low circulating market cap."""
5245
- atlCircMc: String
5246
- """The unix timestamp when the all-time low circulating market cap was reached."""
5247
- atlCircMcTimestamp: Int
5248
- }
5249
-
5250
- """Metadata for a contract."""
5251
- union EnhancedContract = EnhancedToken | EnhancedNftContract
5252
-
5253
- """Community gathered proposals for an asset."""
5254
- type CommunityNote {
5255
- """The contract address of the contract."""
5256
- address: String!
5257
- contractType: ContractType!
5258
- currentContract: EnhancedContract
5259
- """The contract after the community note was applied."""
5260
- currentData: JSON
5261
- """The ID of the contract (`address:id`)."""
5262
- id: String!
5263
- """The unix timestamp of when the community note was moderated."""
5264
- moderatedAt: Int
5265
- """The network ID the contract is deployed on."""
5266
- networkId: Int!
5267
- """The contract before the community note was applied."""
5268
- previousData: JSON
5269
- """The data of the community note."""
5270
- proposalData: JSON!
5271
- """The ordinal number of the community note."""
5272
- proposalNum: Int!
5273
- """The type of the community note."""
5274
- proposalType: CommunityNoteType!
5275
- """The unix timestamp of when the community note was created."""
5276
- proposedAt: Int!
5277
- """The status of the community note."""
5278
- status: ContractProposalStatus!
5279
- sortKey: String!
5280
- }
5281
-
5282
- """Metadata for a decentralized exchange."""
5283
- type Exchange {
5284
- """The ID of the exchange (`address:id`)."""
5285
- id: String!
5286
- """The contract address of the exchange."""
5287
- address: String!
5288
- """The hex string for the exchange color."""
5289
- color: String
5290
- """The name of the exchange."""
5291
- name: String
5292
- """The version of the exchange, if applicable."""
5293
- exchangeVersion: String
5294
- """The exchange logo URL."""
5295
- iconUrl: String
5296
- """The network ID the exchange is deployed on."""
5297
- networkId: Int!
5298
- """The URL for the exchange."""
5299
- tradeUrl: String
5300
- }
5301
-
5302
- """Filters for community notes."""
5303
- input CommunityNotesFilter {
5304
- """The contract address of the contract."""
5305
- address: String
5306
- contractType: ContractType
5307
- """The network ID the contract is deployed on."""
5308
- networkId: [Int]
5309
- """The type of the proposal."""
5310
- proposalType: CommunityNoteType
5311
- }
5312
-
5313
- """Input type of `getCommunityNotes`."""
5314
- input CommunityNotesInput {
5315
- """A set of filters to apply"""
5316
- filter: CommunityNotesFilter
5317
- """The maximum number of community notes to return."""
5318
- limit: Int
5319
- """The cursor to use for pagination."""
5320
- cursor: String
5321
- }
5322
-
5323
- """Community notes data."""
5324
- type CommunityNotesResponse {
5325
- """The list of community notes matching the filter parameters."""
5326
- items: [CommunityNote!]!
5327
- """The number of community notes returned."""
5328
- count: Int!
5329
- """A cursor for use in pagination."""
5330
- cursor: String
5331
- }
5332
-
5333
- """Metadata for a wallet label from the WALLET_LABEL_TYPES vocabulary"""
5334
- type WalletLabelType {
5335
- """Label name (e.g. WHALE, CEX, KOL)"""
5336
- name: String!
5337
- """Human-readable display name"""
5338
- displayName: String!
5339
- """Description of what this label means"""
5340
- description: String!
5341
- }
5342
-
5343
- """A prediction sub-subcategory (3rd level, terminal)."""
5344
- type PredictionSubSubcategory {
5345
- """The display name."""
5346
- name: String!
5347
- """The URL slug."""
5348
- slug: String!
5349
- }
5350
-
5351
- """A prediction subcategory (2nd level)."""
5352
- type PredictionSubcategory {
5353
- """The display name."""
5354
- name: String!
5355
- """The URL slug."""
5356
- slug: String!
5357
- """Nested subcategories (3rd level)."""
5358
- subcategories: [PredictionSubSubcategory!]
5359
- }
5360
-
5361
- """A prediction category with optional nested subcategories."""
5362
- type PredictionCategory {
5363
- """The display name."""
5364
- name: String!
5365
- """The URL slug."""
5366
- slug: String!
5367
- """Nested subcategories (2nd level)."""
5368
- subcategories: [PredictionSubcategory!]
5369
- }
5370
-
5371
- """The duration used to request windowed prediction stats."""
5372
- enum PredictionStatsDuration {
5373
- week1
5374
- day1
5375
- hour12
5376
- hour4
5377
- hour1
5378
- min5
4774
+ """The duration used to request windowed prediction stats."""
4775
+ enum PredictionStatsDuration {
4776
+ week1
4777
+ day1
4778
+ hour12
4779
+ hour4
4780
+ hour1
4781
+ min5
5379
4782
  }
5380
4783
 
5381
4784
  """Input type of `detailedPredictionMarketStats`."""
@@ -8641,6 +8044,10 @@ input PredictionTraderMarketFilters {
8641
8044
  protocol: [PredictionProtocol!]
8642
8045
  """Filter by market status"""
8643
8046
  status: [PredictionEventStatus!]
8047
+ """Filter by labels applied to the trader. Automated accounts are labelled `market-maker` and `high-frequency-bot`; use `excludeTraderLabels` to leave them out of a leaderboard."""
8048
+ traderLabels: [String!]
8049
+ """Exclude traders carrying any of these labels. The usual case is dropping automated accounts from a "top traders" query."""
8050
+ excludeTraderLabels: [String!]
8644
8051
  """Filter by whether trader has an open position"""
8645
8052
  hasOpenPosition: Boolean
8646
8053
  """Filter by outcome 0 PnL status"""
@@ -9423,198 +8830,849 @@ type DetailedSubscriptionPredictionEventStats {
9423
8830
  allTimeStats: PredictionEventAllTimeStats!
9424
8831
  }
9425
8832
 
9426
- """Payload for `onPredictionMarketBarsUpdated`."""
9427
- type OnPredictionMarketBarsUpdatedResponse {
9428
- """The ID of the prediction market."""
9429
- marketId: String!
9430
- """The bar data."""
9431
- bars: PredictionMarketResolutionBarData!
8833
+ """Payload for `onPredictionMarketBarsUpdated`."""
8834
+ type OnPredictionMarketBarsUpdatedResponse {
8835
+ """The ID of the prediction market."""
8836
+ marketId: String!
8837
+ """The bar data."""
8838
+ bars: PredictionMarketResolutionBarData!
8839
+ }
8840
+
8841
+ """Payload for `onPredictionEventBarsUpdated`."""
8842
+ type OnPredictionEventBarsUpdatedResponse {
8843
+ """The ID of the prediction event."""
8844
+ eventId: String!
8845
+ """The bar data."""
8846
+ bars: PredictionEventResolutionBarData!
8847
+ }
8848
+
8849
+ """Multi-resolution bar data for a prediction market."""
8850
+ type PredictionMarketResolutionBarData {
8851
+ """Data for the 1-minute resolution."""
8852
+ min1: PredictionMarketBar
8853
+ """Data for the 5-minute resolution."""
8854
+ min5: PredictionMarketBar
8855
+ """Data for the 15-minute resolution."""
8856
+ min15: PredictionMarketBar
8857
+ """Data for the 30-minute resolution."""
8858
+ min30: PredictionMarketBar
8859
+ """Data for the 1-hour resolution."""
8860
+ hour1: PredictionMarketBar
8861
+ """Data for the 4-hour resolution."""
8862
+ hour4: PredictionMarketBar
8863
+ """Data for the 12-hour resolution."""
8864
+ hour12: PredictionMarketBar
8865
+ """Data for the 1-day resolution."""
8866
+ day1: PredictionMarketBar
8867
+ """Data for the 1-week resolution."""
8868
+ week1: PredictionMarketBar
8869
+ }
8870
+
8871
+ """Multi-resolution bar data for a prediction event."""
8872
+ type PredictionEventResolutionBarData {
8873
+ """Data for the 1-minute resolution."""
8874
+ min1: PredictionEventBar
8875
+ """Data for the 5-minute resolution."""
8876
+ min5: PredictionEventBar
8877
+ """Data for the 15-minute resolution."""
8878
+ min15: PredictionEventBar
8879
+ """Data for the 30-minute resolution."""
8880
+ min30: PredictionEventBar
8881
+ """Data for the 1-hour resolution."""
8882
+ hour1: PredictionEventBar
8883
+ """Data for the 4-hour resolution."""
8884
+ hour4: PredictionEventBar
8885
+ """Data for the 12-hour resolution."""
8886
+ hour12: PredictionEventBar
8887
+ """Data for the 1-day resolution."""
8888
+ day1: PredictionEventBar
8889
+ """Data for the 1-week resolution."""
8890
+ week1: PredictionEventBar
8891
+ }
8892
+
8893
+ """Input for fetching prediction market price data."""
8894
+ input PredictionMarketPriceInput {
8895
+ """The ID of the prediction market."""
8896
+ marketId: String!
8897
+ """The timestamp (unix seconds). If not provided, the latest price will be returned."""
8898
+ timestamp: Int
8899
+ }
8900
+
8901
+ """Price data for a prediction market."""
8902
+ type PredictionMarketPrice {
8903
+ """The ID of the prediction market."""
8904
+ marketId: String!
8905
+ """The timestamp of the price data."""
8906
+ timestamp: Int!
8907
+ """The prices for the outcomes."""
8908
+ outcomes: [PredictionMarketOutcomePrice!]!
8909
+ }
8910
+
8911
+ """Price data for a single outcome within a prediction market."""
8912
+ type PredictionMarketOutcomePrice {
8913
+ """The ID of the outcome."""
8914
+ outcomeId: String!
8915
+ """The last trade price in USD."""
8916
+ lastTradePriceUsd: String
8917
+ """The last trade price in collateral token units."""
8918
+ lastTradePriceCT: String
8919
+ """The best bid in USD."""
8920
+ bestBidUsd: String
8921
+ """The best bid in collateral token units."""
8922
+ bestBidCT: String
8923
+ """The best ask in USD."""
8924
+ bestAskUsd: String
8925
+ """The best ask in collateral token units."""
8926
+ bestAskCT: String
8927
+ """The spread in USD."""
8928
+ spreadUsd: String
8929
+ """The spread in collateral token units."""
8930
+ spreadCT: String
8931
+ """Live top-of-book best bid in USD, sourced from the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
8932
+ bestBookBidUsd: String
8933
+ """Live top-of-book best bid in collateral token units, sourced from the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
8934
+ bestBookBidCT: String
8935
+ """Live top-of-book best ask in USD, sourced from the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
8936
+ bestBookAskUsd: String
8937
+ """Live top-of-book best ask in collateral token units, sourced from the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
8938
+ bestBookAskCT: String
8939
+ """Total bid-side notional liquidity in USD across all bid levels in the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
8940
+ bookLiquidityUsd: String
8941
+ """Total bid-side notional liquidity in collateral token units across all bid levels in the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
8942
+ bookLiquidityCT: String
8943
+ """The timestamp of the price data."""
8944
+ timestamp: Int!
8945
+ }
8946
+
8947
+ """A single price level within a prediction outcome's order book. Polymarket and Kalshi."""
8948
+ type PredictionOrderBookLevel {
8949
+ """The price in collateral token units."""
8950
+ price: Float!
8951
+ """The size at this price level, in shares."""
8952
+ size: Float!
8953
+ }
8954
+
8955
+ """A live order book snapshot for a single prediction outcome, sourced from the venue's CLOB. Polymarket and Kalshi; outcomes from other venues return no book. Cached for up to 10s."""
8956
+ type PredictionOutcomeOrderBook {
8957
+ """The composite outcome ID."""
8958
+ outcomeId: String!
8959
+ """The protocol that provides this market."""
8960
+ protocol: PredictionProtocol!
8961
+ """The venue-specific outcome / asset / token ID used by the venue's CLOB."""
8962
+ venueOutcomeId: String!
8963
+ """Bids ordered such that the last element is the best (highest) bid. Empty when no book is available."""
8964
+ bids: [PredictionOrderBookLevel!]!
8965
+ """Asks ordered such that the last element is the best (lowest) ask. Empty when no book is available."""
8966
+ asks: [PredictionOrderBookLevel!]!
8967
+ """Venue-reported timestamp for the snapshot, in unix seconds. 0 when no book is available."""
8968
+ timestamp: Int!
8969
+ """Total bid-side notional liquidity in USD across all bid levels in the venue's CLOB. Null when no book is available."""
8970
+ bookLiquidityUsd: String
8971
+ """Total bid-side notional liquidity in collateral token units across all bid levels in the venue's CLOB. Null when no book is available."""
8972
+ bookLiquidityCT: String
9432
8973
  }
9433
8974
 
9434
- """Payload for `onPredictionEventBarsUpdated`."""
9435
- type OnPredictionEventBarsUpdatedResponse {
8975
+ """Response returned by `eventScopedFilterPredictionMarkets`. All markets belong to the same event, so `eventShape` and `eventId` are surfaced once at the connection level rather than repeated on every row."""
8976
+ type EventScopedPredictionMarketFilterConnection {
8977
+ """Total number of matching results."""
8978
+ count: Int!
8979
+ """The current page number."""
8980
+ page: Int!
8981
+ """Event-level shape (one per event; identical for all markets in a single-event query)."""
8982
+ eventShape: PredictionEventShape!
9436
8983
  """The ID of the prediction event."""
9437
8984
  eventId: String!
9438
- """The bar data."""
9439
- bars: PredictionEventResolutionBarData!
8985
+ """The list of results."""
8986
+ results: [EventScopedPredictionMarketFilterResult!]!
9440
8987
  }
9441
8988
 
9442
- """Multi-resolution bar data for a prediction market."""
9443
- type PredictionMarketResolutionBarData {
9444
- """Data for the 1-minute resolution."""
9445
- min1: PredictionMarketBar
9446
- """Data for the 5-minute resolution."""
9447
- min5: PredictionMarketBar
9448
- """Data for the 15-minute resolution."""
9449
- min15: PredictionMarketBar
9450
- """Data for the 30-minute resolution."""
9451
- min30: PredictionMarketBar
9452
- """Data for the 1-hour resolution."""
9453
- hour1: PredictionMarketBar
9454
- """Data for the 4-hour resolution."""
9455
- hour4: PredictionMarketBar
9456
- """Data for the 12-hour resolution."""
9457
- hour12: PredictionMarketBar
9458
- """Data for the 1-day resolution."""
9459
- day1: PredictionMarketBar
9460
- """Data for the 1-week resolution."""
9461
- week1: PredictionMarketBar
8989
+ """A prediction market scoped to a single event, paired with its structured classification metadata."""
8990
+ type EventScopedPredictionMarketFilterResult {
8991
+ """The prediction market filter result."""
8992
+ marketResult: PredictionMarketFilterResult!
8993
+ """Structured classification metadata. Discriminated by `classification.role`; carries `segment` (period/stat), `entrant` (with country code / image), `thresholdBucket` (parsed numeric rung + operator), and `dateBucket` (unix timestamp + operator) sub-blocks. See `MarketClassifier/CLASSIFICATION.md` for the consumer guide."""
8994
+ classification: PredictionMarketClassification!
9462
8995
  }
9463
8996
 
9464
- """Multi-resolution bar data for a prediction event."""
9465
- type PredictionEventResolutionBarData {
9466
- """Data for the 1-minute resolution."""
9467
- min1: PredictionEventBar
9468
- """Data for the 5-minute resolution."""
9469
- min5: PredictionEventBar
9470
- """Data for the 15-minute resolution."""
9471
- min15: PredictionEventBar
9472
- """Data for the 30-minute resolution."""
9473
- min30: PredictionEventBar
9474
- """Data for the 1-hour resolution."""
9475
- hour1: PredictionEventBar
9476
- """Data for the 4-hour resolution."""
9477
- hour4: PredictionEventBar
9478
- """Data for the 12-hour resolution."""
9479
- hour12: PredictionEventBar
9480
- """Data for the 1-day resolution."""
9481
- day1: PredictionEventBar
9482
- """Data for the 1-week resolution."""
9483
- week1: PredictionEventBar
8997
+ """Deprecated. Sort order for markets within a prediction event. This no longer affects market ordering."""
8998
+ enum PredictionEventMarketSort {
8999
+ """Deprecated. No longer affects market ordering."""
9000
+ SMART @deprecated(reason: "No longer affects market ordering.")
9001
+ """Deprecated. No longer affects market ordering."""
9002
+ NONE @deprecated(reason: "No longer affects market ordering.")
9003
+ }
9004
+
9005
+ scalar Void
9006
+
9007
+ """Type of the community gathered note."""
9008
+ enum CommunityNoteType {
9009
+ """An contract attribute change."""
9010
+ ATTRIBUTE
9011
+ """A scam report."""
9012
+ SCAM
9013
+ """A logo change."""
9014
+ LOGO
9015
+ }
9016
+
9017
+ """Type of the contract."""
9018
+ enum ContractType {
9019
+ TOKEN
9020
+ WALLET
9021
+ }
9022
+
9023
+ enum ContractProposalStatus {
9024
+ ACCEPTED
9025
+ PENDING
9026
+ REJECTED
9027
+ REVERTED
9028
+ }
9029
+
9030
+ """The attribute used to rank tokens."""
9031
+ enum TokenRankingAttribute {
9032
+ """Weighted risk score."""
9033
+ riskScore
9034
+ """Unix seconds of the token's latest recorded risk change."""
9035
+ riskFlaggedAt
9036
+ createdAt
9037
+ tokenCreatedAt
9038
+ lastTransaction
9039
+ age @deprecated(reason: "Use createdAt instead")
9040
+ buyCount5m
9041
+ buyCount1
9042
+ buyCount4
9043
+ buyCount12
9044
+ buyCount24
9045
+ change5m
9046
+ change1
9047
+ change4
9048
+ change12
9049
+ change24
9050
+ volumeChange5m
9051
+ volumeChange1
9052
+ volumeChange4
9053
+ volumeChange12
9054
+ volumeChange24
9055
+ high5m
9056
+ high1
9057
+ high4
9058
+ high12
9059
+ high24
9060
+ holders
9061
+ notableHolderCount
9062
+ liquidity
9063
+ totalLiquidityUsd
9064
+ low5m
9065
+ low1
9066
+ low4
9067
+ low12
9068
+ low24
9069
+ marketCap
9070
+ circulatingMarketCap
9071
+ priceUSD
9072
+ sellCount5m
9073
+ sellCount1
9074
+ sellCount4
9075
+ sellCount12
9076
+ sellCount24
9077
+ trendingScore
9078
+ trendingScore5m
9079
+ trendingScore1
9080
+ trendingScore4
9081
+ trendingScore12
9082
+ trendingScore24
9083
+ txnCount5m
9084
+ txnCount1
9085
+ txnCount4
9086
+ txnCount12
9087
+ txnCount24
9088
+ uniqueBuys5m
9089
+ uniqueBuys1
9090
+ uniqueBuys4
9091
+ uniqueBuys12
9092
+ uniqueBuys24
9093
+ uniqueSells5m
9094
+ uniqueSells1
9095
+ uniqueSells4
9096
+ uniqueSells12
9097
+ uniqueSells24
9098
+ uniqueTransactions5m
9099
+ uniqueTransactions1
9100
+ uniqueTransactions4
9101
+ uniqueTransactions12
9102
+ uniqueTransactions24
9103
+ volume5m
9104
+ volume1
9105
+ volume4
9106
+ volume12
9107
+ volume24
9108
+ buyVolume5m
9109
+ buyVolume1
9110
+ buyVolume4
9111
+ buyVolume12
9112
+ buyVolume24
9113
+ sellVolume5m
9114
+ sellVolume1
9115
+ sellVolume4
9116
+ sellVolume12
9117
+ sellVolume24
9118
+ poolFees5m
9119
+ poolFees1
9120
+ poolFees4
9121
+ poolFees12
9122
+ poolFees24
9123
+ baseFees5m
9124
+ baseFees1
9125
+ baseFees4
9126
+ baseFees12
9127
+ baseFees24
9128
+ priorityFees5m
9129
+ priorityFees1
9130
+ priorityFees4
9131
+ priorityFees12
9132
+ priorityFees24
9133
+ builderTips5m
9134
+ builderTips1
9135
+ builderTips4
9136
+ builderTips12
9137
+ builderTips24
9138
+ l1DataFees5m
9139
+ l1DataFees1
9140
+ l1DataFees4
9141
+ l1DataFees12
9142
+ l1DataFees24
9143
+ totalFees5m
9144
+ totalFees1
9145
+ totalFees4
9146
+ totalFees12
9147
+ totalFees24
9148
+ feeToVolumeRatio5m
9149
+ feeToVolumeRatio1
9150
+ feeToVolumeRatio4
9151
+ feeToVolumeRatio12
9152
+ feeToVolumeRatio24
9153
+ launchpadCompletedAt
9154
+ launchpadMigratedAt
9155
+ graduationPercent
9156
+ walletAgeAvg
9157
+ walletAgeStd
9158
+ swapPct1dOldWallet
9159
+ swapPct7dOldWallet
9160
+ sniperHeldPercentage
9161
+ bundlerHeldPercentage
9162
+ insiderHeldPercentage
9163
+ suspiciousHeldPercentage
9164
+ sniperCount
9165
+ bundlerCount
9166
+ insiderCount
9167
+ suspiciousCount
9168
+ devHeldPercentage
9169
+ top10HoldersPercent
9170
+ coinCommunityPostCount
9171
+ coinCommunityMemberCount
9172
+ coinCommunityLikeCount
9173
+ coinCommunityLastPostAt
9484
9174
  }
9485
9175
 
9486
- """Input for fetching prediction market price data."""
9487
- input PredictionMarketPriceInput {
9488
- """The ID of the prediction market."""
9489
- marketId: String!
9490
- """The timestamp (unix seconds). If not provided, the latest price will be returned."""
9176
+ """Input type of `TokenRanking`."""
9177
+ input TokenRanking {
9178
+ """The attribute to rank tokens by."""
9179
+ attribute: TokenRankingAttribute
9180
+ """The direction to apply to the ranking attribute."""
9181
+ direction: RankingDirection
9182
+ }
9183
+
9184
+ """Real-time or historical prices for a token."""
9185
+ type Price {
9186
+ """The contract address of the token."""
9187
+ address: String!
9188
+ """The unix timestamp for the price."""
9491
9189
  timestamp: Int
9190
+ """The network ID the token is deployed on."""
9191
+ networkId: Int!
9192
+ """The token price in USD."""
9193
+ priceUsd: Float!
9194
+ """The pool that emitted the swap generating this price"""
9195
+ blockNumber: Int
9196
+ """The token's liquidity in USD. On networks where the real-money total is enabled, this is `totalLiquidityUsd` from `filterTokens`: the combined liquidity of its 15 deepest pools, leaving out pools with no trade in the last 7 days, where each pool counts only the real money the token can reach in one or two trades into the network's pricing reference tokens (such as its main stablecoins), with each route counted once. Elsewhere, or until that total is computed for the token, it is the token's route-backed liquidity, summed across its pairs with valid routing liquidity. Null when this stat has not been computed for the token yet. Not available via subscription."""
9197
+ liquidityUsd: String
9198
+ """The percent price change in the past 24 hours. Decimal format. Not available via subscription."""
9199
+ priceChange24: Float
9200
+ """The pool that emitted the swap generating this price"""
9201
+ poolAddress: String @deprecated(reason: "Pricing no longer based on specific pools")
9202
+ """Ratio of how confident we are in the price"""
9203
+ confidence: Float @deprecated(reason: "Pricing no longer based on specific pools")
9492
9204
  }
9493
9205
 
9494
- """Price data for a prediction market."""
9495
- type PredictionMarketPrice {
9496
- """The ID of the prediction market."""
9497
- marketId: String!
9498
- """The timestamp of the price data."""
9499
- timestamp: Int!
9500
- """The prices for the outcomes."""
9501
- outcomes: [PredictionMarketOutcomePrice!]!
9206
+ """Metadata for a token."""
9207
+ type EnhancedToken {
9208
+ """The ID of the token (`address:networkId`)."""
9209
+ id: String!
9210
+ """The contract address of the token."""
9211
+ address: String!
9212
+ """The token ID on CoinMarketCap."""
9213
+ cmcId: Int
9214
+ """The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals)."""
9215
+ decimals: Int!
9216
+ """Whether the token has been flagged as a scam."""
9217
+ isScam: Boolean
9218
+ """The token name. For example, `ApeCoin`."""
9219
+ name: String
9220
+ """The network ID the token is deployed on."""
9221
+ networkId: Int!
9222
+ """The token symbol. For example, `APE`."""
9223
+ symbol: String
9224
+ """The total supply of the token."""
9225
+ totalSupply: String @deprecated(reason: "Use the TokenInfo type")
9226
+ """Community gathered links for the socials of this token."""
9227
+ socialLinks: SocialLinks
9228
+ """More metadata about the token."""
9229
+ info: TokenInfo
9230
+ """The Grid asset ID, if this token is linked to a Grid asset."""
9231
+ gridAssetId: String
9232
+ """The Grid bluechip rating for this token (e.g. `A+`, `B-`)."""
9233
+ bluechipRating: String
9234
+ """The Grid organization associated with this token. Null when the token is reached through `AssetDeployment.token`."""
9235
+ organization: Organization
9236
+ """The Grid asset associated with this token. Null when the token is reached through `AssetDeployment.token`."""
9237
+ asset: Asset
9238
+ """Information about the token from 3rd party sources."""
9239
+ explorerData: ExplorerTokenData @deprecated(reason: "Use the TokenInfo type")
9240
+ """A list of exchanges where the token has been traded."""
9241
+ exchanges: [Exchange!]
9242
+ """The thumbnail token logo URL."""
9243
+ imageThumbUrl: String @deprecated(reason: "Use the TokenInfo type")
9244
+ """The small token logo URL."""
9245
+ imageSmallUrl: String @deprecated(reason: "Use the TokenInfo type")
9246
+ """The large token logo URL."""
9247
+ imageLargeUrl: String @deprecated(reason: "Use the TokenInfo type")
9248
+ """The circulating supply of the token."""
9249
+ circulatingSupply: String @deprecated(reason: "Use the TokenInfo type")
9250
+ """The amount of this token in the pair."""
9251
+ pooled: String @deprecated(reason: "Pooled can be found on the pair instead")
9252
+ """The token creator's wallet address."""
9253
+ creatorAddress: String
9254
+ """The token creator's wallet identity and profile, resolved from creatorAddress. Null when the token has no known creator."""
9255
+ creator: Wallet
9256
+ """The token creator's network-based token balance at time of contract creation."""
9257
+ creatorBalanceNBT: String
9258
+ """The block height the token was created at."""
9259
+ createBlockNumber: Int
9260
+ """The transaction hash of the token's creation."""
9261
+ createTransactionHash: String
9262
+ """The unix timestamp for the creation of the token."""
9263
+ createdAt: Int
9264
+ """Returns mint authority address if token is mintable. If null, verify against isMintableValid."""
9265
+ mintable: String
9266
+ """Returns freeze authority address if token is freezable. If null, verify against isFreezableValid."""
9267
+ freezable: String
9268
+ """Determines if freezable is a valid address or null value for the authority, or if the freezable state has not yet been determined."""
9269
+ isFreezableValid: Boolean
9270
+ """Determines if mintable is a valid address or null value for the authority, or if the mintable state has not yet been determined."""
9271
+ isMintableValid: Boolean
9272
+ """The launchpad data for the token, if applicable."""
9273
+ launchpad: LaunchpadData
9274
+ """The percentage of total supply held by the top 10 holders (excluding exchanges/pairs)."""
9275
+ top10HoldersPercent: Float
9276
+ """Whether the token name or symbol contains profanity."""
9277
+ profanity: Boolean
9278
+ """All-time high and low price/market cap data for the token."""
9279
+ extrema: TokenExtrema
9280
+ """The Coin Community data for the token"""
9281
+ coinCommunity: CoinCommunity
9282
+ """Token extension metadata, if available."""
9283
+ extensions: TokenExtensions
9284
+ """Token-standard-specific custom metadata — currently ERC-7572 `contractURI` fields, as used by Base B20 tokens. Null for tokens without a recognized token standard."""
9285
+ tokenStandardCustomData: Erc7572CustomInfo
9286
+ categories: [Category!]
9287
+ """Codex's unified risk assessment for this token — one verdict, the score behind it, how much analysis stood behind that score, and the reasons that fired. Read `coverage` before trusting `verdict`."""
9288
+ risk: TokenRisk
9502
9289
  }
9503
9290
 
9504
- """Price data for a single outcome within a prediction market."""
9505
- type PredictionMarketOutcomePrice {
9506
- """The ID of the outcome."""
9507
- outcomeId: String!
9508
- """The last trade price in USD."""
9509
- lastTradePriceUsd: String
9510
- """The last trade price in collateral token units."""
9511
- lastTradePriceCT: String
9512
- """The best bid in USD."""
9513
- bestBidUsd: String
9514
- """The best bid in collateral token units."""
9515
- bestBidCT: String
9516
- """The best ask in USD."""
9517
- bestAskUsd: String
9518
- """The best ask in collateral token units."""
9519
- bestAskCT: String
9520
- """The spread in USD."""
9521
- spreadUsd: String
9522
- """The spread in collateral token units."""
9523
- spreadCT: String
9524
- """Live top-of-book best bid in USD, sourced from the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
9525
- bestBookBidUsd: String
9526
- """Live top-of-book best bid in collateral token units, sourced from the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
9527
- bestBookBidCT: String
9528
- """Live top-of-book best ask in USD, sourced from the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
9529
- bestBookAskUsd: String
9530
- """Live top-of-book best ask in collateral token units, sourced from the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
9531
- bestBookAskCT: String
9532
- """Total bid-side notional liquidity in USD across all bid levels in the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
9533
- bookLiquidityUsd: String
9534
- """Total bid-side notional liquidity in collateral token units across all bid levels in the venue's CLOB. Polymarket and Kalshi; null for other venues. Fetched on-demand only when selected. Cached for up to 10s."""
9535
- bookLiquidityCT: String
9536
- """The timestamp of the price data."""
9537
- timestamp: Int!
9291
+ """A token matching a set of filter parameters."""
9292
+ type TokenFilterResult {
9293
+ """Metadata for the token."""
9294
+ token: EnhancedToken
9295
+ """The unix timestamp for the creation of the token's first pair."""
9296
+ createdAt: Int
9297
+ """The unix timestamp for the token's last transaction."""
9298
+ lastTransaction: Int
9299
+ age: Int @deprecated(reason: "Age isn't supported - use createdAt instead")
9300
+ """The number of buys in the past 5 minutes."""
9301
+ buyCount5m: Int
9302
+ """The number of buys in the past hour."""
9303
+ buyCount1: Int
9304
+ """The number of buys in the past 12 hours."""
9305
+ buyCount12: Int
9306
+ """The number of buys in the past 24 hours."""
9307
+ buyCount24: Int
9308
+ """The number of buys in the past 4 hours."""
9309
+ buyCount4: Int
9310
+ """The percent price change in the past 5 minutes. Decimal format."""
9311
+ change5m: String
9312
+ """The percent price change in the past hour. Decimal format."""
9313
+ change1: String
9314
+ """The percent price change in the past 12 hours. Decimal format."""
9315
+ change12: String
9316
+ """The percent price change in the past 24 hours. Decimal format."""
9317
+ change24: String
9318
+ """The percent price change in the past 4 hours. Decimal format."""
9319
+ change4: String
9320
+ """The percent volume change in the past 5 minutes. Decimal format."""
9321
+ volumeChange5m: String
9322
+ """The percent volume change in the past hour. Decimal format."""
9323
+ volumeChange1: String
9324
+ """The percent volume change in the past 4 hours. Decimal format."""
9325
+ volumeChange4: String
9326
+ """The percent volume change in the past 12 hours. Decimal format."""
9327
+ volumeChange12: String
9328
+ """The percent volume change in the past 24 hours. Decimal format."""
9329
+ volumeChange24: String
9330
+ """The exchanges the token is listed on."""
9331
+ exchanges: [Exchange]
9332
+ fdv: String @deprecated(reason: "FDV isn't supported - use marketCap instead")
9333
+ """The highest price in USD in the past 5 minutes."""
9334
+ high5m: String
9335
+ """The highest price in USD in the past hour."""
9336
+ high1: String
9337
+ """The highest price in USD in the past 12 hours."""
9338
+ high12: String
9339
+ """The highest price in USD in the past 24 hours."""
9340
+ high24: String
9341
+ """The highest price in USD in the past 4 hours."""
9342
+ high4: String
9343
+ """Amount of liquidity in the token's top pair. With `useAggregatedStats`, on networks where the real-money total is enabled, this is the same value as `totalLiquidityUsd` once the token has one; on other networks it is the token's aggregated liquidity. The value is recomputed when the token trades, so a token with no trade since this definition last changed keeps its previous value."""
9344
+ liquidity: String
9345
+ """The token's total liquidity in USD: the combined liquidity of its 15 deepest pools, leaving out pools with no trade in the last 7 days. On networks where the real-money total is enabled, each pool counts only the real money behind it: what the token can reach in one or two trades into the network's pricing reference tokens (such as its main stablecoins), with each route counted once. Distinct from `liquidity`, which covers the top pair only, except with `useAggregatedStats` on networks where the real-money total is enabled, where the two are the same value. The value is recomputed when the token trades, so a token with no trade since this definition last changed keeps its previous value. Null when this stat has not been computed for the token yet."""
9346
+ totalLiquidityUsd: String
9347
+ """The token of interest. Can be `token0` or `token1`."""
9348
+ quoteToken: String
9349
+ """The lowest price in USD in the past 5 minutes."""
9350
+ low5m: String
9351
+ """The lowest price in USD in the past hour."""
9352
+ low1: String
9353
+ """The lowest price in USD in the past 12 hours."""
9354
+ low12: String
9355
+ """The lowest price in USD in the past 24 hours."""
9356
+ low24: String
9357
+ """The lowest price in USD in the past 4 hours."""
9358
+ low4: String
9359
+ """The fully diluted market cap."""
9360
+ marketCap: String
9361
+ """The circulating market cap."""
9362
+ circulatingMarketCap: String
9363
+ """Metadata for the token's top pair."""
9364
+ pair: Pair
9365
+ """Metadata for the token's most liquid pair"""
9366
+ liquidPair: Pair
9367
+ """The liquidity of the token's most liquid pair"""
9368
+ liquidPairLiquidity: String
9369
+ """The liquid pairs price in USD."""
9370
+ liquidPairPriceUSD: String
9371
+ """The token price in USD."""
9372
+ priceUSD: String
9373
+ """A heuristic based on various factors used to rank tokens based on how trending they are."""
9374
+ trendingScore: Float
9375
+ """The number of sells in the past 5 minutes."""
9376
+ sellCount5m: Int
9377
+ """The number of sells in the past hour."""
9378
+ sellCount1: Int
9379
+ """The number of sells in the past 12 hours."""
9380
+ sellCount12: Int
9381
+ """The number of sells in the past 24 hours."""
9382
+ sellCount24: Int
9383
+ """The number of sells in the past 4 hours."""
9384
+ sellCount4: Int
9385
+ """The number of transactions in the past 5 minutes."""
9386
+ txnCount5m: Int
9387
+ """The number of transactions in the past hour."""
9388
+ txnCount1: Int
9389
+ """The number of transactions in the past 12 hours."""
9390
+ txnCount12: Int
9391
+ """The number of transactions in the past 24 hours."""
9392
+ txnCount24: Int
9393
+ """The number of transactions in the past 4 hours."""
9394
+ txnCount4: Int
9395
+ """The unique number of buys in the past 5 minutes."""
9396
+ uniqueBuys5m: Int
9397
+ """The unique number of buys in the past hour."""
9398
+ uniqueBuys1: Int
9399
+ """The unique number of buys in the past 12 hours."""
9400
+ uniqueBuys12: Int
9401
+ """The unique number of buys in the past 24 hours."""
9402
+ uniqueBuys24: Int
9403
+ """The unique number of buys in the past 4 hours."""
9404
+ uniqueBuys4: Int
9405
+ """The unique number of sells in the past 5 minutes."""
9406
+ uniqueSells5m: Int
9407
+ """The unique number of sells in the past hour."""
9408
+ uniqueSells1: Int
9409
+ """The unique number of sells in the past 12 hours."""
9410
+ uniqueSells12: Int
9411
+ """The unique number of sells in the past 24 hours."""
9412
+ uniqueSells24: Int
9413
+ """The unique number of sells in the past 4 hours."""
9414
+ uniqueSells4: Int
9415
+ """The unique number of transactions in the past 5 minutes."""
9416
+ uniqueTransactions5m: Int
9417
+ """The unique number of transactions in the past hour."""
9418
+ uniqueTransactions1: Int
9419
+ """The unique number of transactions in the past 12 hours."""
9420
+ uniqueTransactions12: Int
9421
+ """The unique number of transactions in the past 24 hours."""
9422
+ uniqueTransactions24: Int
9423
+ """The unique number of transactions in the past 4 hours."""
9424
+ uniqueTransactions4: Int
9425
+ """The trade volume in USD in the past hour."""
9426
+ volume1: String
9427
+ """The trade volume in USD in the past 5 minutes."""
9428
+ volume5m: String
9429
+ """The trade volume in USD in the past 12 hours."""
9430
+ volume12: String
9431
+ """The trade volume in USD in the past 24 hours."""
9432
+ volume24: String
9433
+ """The trade volume in USD in the past 4 hours."""
9434
+ volume4: String
9435
+ """The buy volume in USD in the past hour."""
9436
+ buyVolume1: String
9437
+ """The buy volume in USD in the past 12 hours."""
9438
+ buyVolume12: String
9439
+ """The buy volume in USD in the past 24 hours."""
9440
+ buyVolume24: String
9441
+ """The buy volume in USD in the past 4 hours."""
9442
+ buyVolume4: String
9443
+ """The buy volume in USD in the past 5 minutes."""
9444
+ buyVolume5m: String
9445
+ """The sell volume in USD in the past hour."""
9446
+ sellVolume1: String
9447
+ """The sell volume in USD in the past 12 hours."""
9448
+ sellVolume12: String
9449
+ """The sell volume in USD in the past 24 hours."""
9450
+ sellVolume24: String
9451
+ """The sell volume in USD in the past 4 hours."""
9452
+ sellVolume4: String
9453
+ """The sell volume in USD in the past 5 minutes."""
9454
+ sellVolume5m: String
9455
+ """The total pool fees in USD in the past 5 minutes."""
9456
+ poolFees5m: String
9457
+ """The total pool fees in USD in the past hour."""
9458
+ poolFees1: String
9459
+ """The total pool fees in USD in the past 4 hours."""
9460
+ poolFees4: String
9461
+ """The total pool fees in USD in the past 12 hours."""
9462
+ poolFees12: String
9463
+ """The total pool fees in USD in the past 24 hours."""
9464
+ poolFees24: String
9465
+ """The total base gas fees in USD in the past 5 minutes."""
9466
+ baseFees5m: String
9467
+ """The total base gas fees in USD in the past hour."""
9468
+ baseFees1: String
9469
+ """The total base gas fees in USD in the past 4 hours."""
9470
+ baseFees4: String
9471
+ """The total base gas fees in USD in the past 12 hours."""
9472
+ baseFees12: String
9473
+ """The total base gas fees in USD in the past 24 hours."""
9474
+ baseFees24: String
9475
+ """The total priority fees in USD in the past 5 minutes."""
9476
+ priorityFees5m: String
9477
+ """The total priority fees in USD in the past hour."""
9478
+ priorityFees1: String
9479
+ """The total priority fees in USD in the past 4 hours."""
9480
+ priorityFees4: String
9481
+ """The total priority fees in USD in the past 12 hours."""
9482
+ priorityFees12: String
9483
+ """The total priority fees in USD in the past 24 hours."""
9484
+ priorityFees24: String
9485
+ """The total builder tips (MEV) in USD in the past 5 minutes."""
9486
+ builderTips5m: String
9487
+ """The total builder tips (MEV) in USD in the past hour."""
9488
+ builderTips1: String
9489
+ """The total builder tips (MEV) in USD in the past 4 hours."""
9490
+ builderTips4: String
9491
+ """The total builder tips (MEV) in USD in the past 12 hours."""
9492
+ builderTips12: String
9493
+ """The total builder tips (MEV) in USD in the past 24 hours."""
9494
+ builderTips24: String
9495
+ """The total L1 data fees in USD in the past 5 minutes."""
9496
+ l1DataFees5m: String
9497
+ """The total L1 data fees in USD in the past hour."""
9498
+ l1DataFees1: String
9499
+ """The total L1 data fees in USD in the past 4 hours."""
9500
+ l1DataFees4: String
9501
+ """The total L1 data fees in USD in the past 12 hours."""
9502
+ l1DataFees12: String
9503
+ """The total L1 data fees in USD in the past 24 hours."""
9504
+ l1DataFees24: String
9505
+ """The total trading fees (pool + gas + tips) in USD in the past 5 minutes."""
9506
+ totalFees5m: String
9507
+ """The total trading fees (pool + gas + tips) in USD in the past hour."""
9508
+ totalFees1: String
9509
+ """The total trading fees (pool + gas + tips) in USD in the past 4 hours."""
9510
+ totalFees4: String
9511
+ """The total trading fees (pool + gas + tips) in USD in the past 12 hours."""
9512
+ totalFees12: String
9513
+ """The total trading fees (pool + gas + tips) in USD in the past 24 hours."""
9514
+ totalFees24: String
9515
+ """The ratio of total fees to volume in the past 5 minutes. Decimal format."""
9516
+ feeToVolumeRatio5m: String
9517
+ """The ratio of total fees to volume in the past hour. Decimal format."""
9518
+ feeToVolumeRatio1: String
9519
+ """The ratio of total fees to volume in the past 4 hours. Decimal format."""
9520
+ feeToVolumeRatio4: String
9521
+ """The ratio of total fees to volume in the past 12 hours. Decimal format."""
9522
+ feeToVolumeRatio12: String
9523
+ """The ratio of total fees to volume in the past 24 hours. Decimal format."""
9524
+ feeToVolumeRatio24: String
9525
+ """Whether the token has been flagged as a scam."""
9526
+ isScam: Boolean
9527
+ """The number of different wallets holding the token."""
9528
+ holders: Int
9529
+ """The average age of the wallets that traded in the last 24h"""
9530
+ walletAgeAvg: String
9531
+ """The standard deviation of age of the wallets that traded in the last 24h"""
9532
+ walletAgeStd: String
9533
+ """The percentage of wallets that are less than 1d old that have traded in the last 24h"""
9534
+ swapPct1dOldWallet: String
9535
+ """The percentage of wallets that are less than 7d old that have traded in the last 24h"""
9536
+ swapPct7dOldWallet: String
9537
+ """The number of wallets that have sniped the token"""
9538
+ sniperCount: Int
9539
+ """The percentage of tokens held by snipers"""
9540
+ sniperHeldPercentage: Float
9541
+ """The number of wallets that have bundled the token"""
9542
+ bundlerCount: Int
9543
+ """The percentage of tokens held by bundlers"""
9544
+ bundlerHeldPercentage: Float
9545
+ """The number of wallets that have been an insider of the token"""
9546
+ insiderCount: Int
9547
+ """The percentage of tokens held by insiders"""
9548
+ insiderHeldPercentage: Float
9549
+ """The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders)"""
9550
+ suspiciousCount: Int
9551
+ """The percentage of tokens held by suspicious wallets"""
9552
+ suspiciousHeldPercentage: Float
9553
+ """The percentage of tokens held by the dev"""
9554
+ devHeldPercentage: Float
9555
+ """The percentage of total supply held by the top 10 holders."""
9556
+ top10HoldersPercent: Float
9557
+ """The reasons the token has been flagged as a potential scam."""
9558
+ potentialScamReasons: [PotentialScamReason]
9559
+ """The all-time high price in USD."""
9560
+ athPrice: String
9561
+ """The unix timestamp when the all-time high price was reached."""
9562
+ athPriceTimestamp: Int
9563
+ """The all-time low price in USD."""
9564
+ atlPrice: String
9565
+ """The unix timestamp when the all-time low price was reached."""
9566
+ atlPriceTimestamp: Int
9567
+ """The all-time high fully diluted market cap."""
9568
+ athFdv: String
9569
+ """The unix timestamp when the all-time high FDV was reached."""
9570
+ athFdvTimestamp: Int
9571
+ """The all-time low fully diluted market cap."""
9572
+ atlFdv: String
9573
+ """The unix timestamp when the all-time low FDV was reached."""
9574
+ atlFdvTimestamp: Int
9575
+ """The all-time high circulating market cap."""
9576
+ athCircMc: String
9577
+ """The unix timestamp when the all-time high circulating market cap was reached."""
9578
+ athCircMcTimestamp: Int
9579
+ """The all-time low circulating market cap."""
9580
+ atlCircMc: String
9581
+ """The unix timestamp when the all-time low circulating market cap was reached."""
9582
+ atlCircMcTimestamp: Int
9538
9583
  }
9539
9584
 
9540
- """A single price level within a prediction outcome's order book. Polymarket and Kalshi."""
9541
- type PredictionOrderBookLevel {
9542
- """The price in collateral token units."""
9543
- price: Float!
9544
- """The size at this price level, in shares."""
9545
- size: Float!
9546
- }
9585
+ """Metadata for a contract."""
9586
+ union EnhancedContract = EnhancedToken | EnhancedNftContract
9547
9587
 
9548
- """A live order book snapshot for a single prediction outcome, sourced from the venue's CLOB. Polymarket and Kalshi; outcomes from other venues return no book. Cached for up to 10s."""
9549
- type PredictionOutcomeOrderBook {
9550
- """The composite outcome ID."""
9551
- outcomeId: String!
9552
- """The protocol that provides this market."""
9553
- protocol: PredictionProtocol!
9554
- """The venue-specific outcome / asset / token ID used by the venue's CLOB."""
9555
- venueOutcomeId: String!
9556
- """Bids ordered such that the last element is the best (highest) bid. Empty when no book is available."""
9557
- bids: [PredictionOrderBookLevel!]!
9558
- """Asks ordered such that the last element is the best (lowest) ask. Empty when no book is available."""
9559
- asks: [PredictionOrderBookLevel!]!
9560
- """Venue-reported timestamp for the snapshot, in unix seconds. 0 when no book is available."""
9561
- timestamp: Int!
9562
- """Total bid-side notional liquidity in USD across all bid levels in the venue's CLOB. Null when no book is available."""
9563
- bookLiquidityUsd: String
9564
- """Total bid-side notional liquidity in collateral token units across all bid levels in the venue's CLOB. Null when no book is available."""
9565
- bookLiquidityCT: String
9588
+ """Community gathered proposals for an asset."""
9589
+ type CommunityNote {
9590
+ """The contract address of the contract."""
9591
+ address: String!
9592
+ contractType: ContractType!
9593
+ currentContract: EnhancedContract
9594
+ """The contract after the community note was applied."""
9595
+ currentData: JSON
9596
+ """The ID of the contract (`address:id`)."""
9597
+ id: String!
9598
+ """The unix timestamp of when the community note was moderated."""
9599
+ moderatedAt: Int
9600
+ """The network ID the contract is deployed on."""
9601
+ networkId: Int!
9602
+ """The contract before the community note was applied."""
9603
+ previousData: JSON
9604
+ """The data of the community note."""
9605
+ proposalData: JSON!
9606
+ """The ordinal number of the community note."""
9607
+ proposalNum: Int!
9608
+ """The type of the community note."""
9609
+ proposalType: CommunityNoteType!
9610
+ """The unix timestamp of when the community note was created."""
9611
+ proposedAt: Int!
9612
+ """The status of the community note."""
9613
+ status: ContractProposalStatus!
9614
+ sortKey: String!
9566
9615
  }
9567
9616
 
9568
- """Response returned by `eventScopedFilterPredictionMarkets`. All markets belong to the same event, so `eventShape` and `eventId` are surfaced once at the connection level rather than repeated on every row."""
9569
- type EventScopedPredictionMarketFilterConnection {
9570
- """Total number of matching results."""
9571
- count: Int!
9572
- """The current page number."""
9573
- page: Int!
9574
- """Event-level shape (one per event; identical for all markets in a single-event query)."""
9575
- eventShape: PredictionEventShape!
9576
- """The ID of the prediction event."""
9577
- eventId: String!
9578
- """The list of results."""
9579
- results: [EventScopedPredictionMarketFilterResult!]!
9617
+ """Metadata for a decentralized exchange."""
9618
+ type Exchange {
9619
+ """The ID of the exchange (`address:id`)."""
9620
+ id: String!
9621
+ """The contract address of the exchange."""
9622
+ address: String!
9623
+ """The hex string for the exchange color."""
9624
+ color: String
9625
+ """The name of the exchange."""
9626
+ name: String
9627
+ """The version of the exchange, if applicable."""
9628
+ exchangeVersion: String
9629
+ """The exchange logo URL."""
9630
+ iconUrl: String
9631
+ """The network ID the exchange is deployed on."""
9632
+ networkId: Int!
9633
+ """The URL for the exchange."""
9634
+ tradeUrl: String
9580
9635
  }
9581
9636
 
9582
- """A prediction market scoped to a single event, paired with its structured classification metadata."""
9583
- type EventScopedPredictionMarketFilterResult {
9584
- """The prediction market filter result."""
9585
- marketResult: PredictionMarketFilterResult!
9586
- """Structured classification metadata. Discriminated by `classification.role`; carries `segment` (period/stat), `entrant` (with country code / image), `thresholdBucket` (parsed numeric rung + operator), and `dateBucket` (unix timestamp + operator) sub-blocks. See `MarketClassifier/CLASSIFICATION.md` for the consumer guide."""
9587
- classification: PredictionMarketClassification!
9637
+ """Filters for community notes."""
9638
+ input CommunityNotesFilter {
9639
+ """The contract address of the contract."""
9640
+ address: String
9641
+ contractType: ContractType
9642
+ """The network ID the contract is deployed on."""
9643
+ networkId: [Int]
9644
+ """The type of the proposal."""
9645
+ proposalType: CommunityNoteType
9588
9646
  }
9589
9647
 
9590
- """Deprecated. Sort order for markets within a prediction event. This no longer affects market ordering."""
9591
- enum PredictionEventMarketSort {
9592
- """Deprecated. No longer affects market ordering."""
9593
- SMART @deprecated(reason: "No longer affects market ordering.")
9594
- """Deprecated. No longer affects market ordering."""
9595
- NONE @deprecated(reason: "No longer affects market ordering.")
9648
+ """Input type of `getCommunityNotes`."""
9649
+ input CommunityNotesInput {
9650
+ """A set of filters to apply"""
9651
+ filter: CommunityNotesFilter
9652
+ """The maximum number of community notes to return."""
9653
+ limit: Int
9654
+ """The cursor to use for pagination."""
9655
+ cursor: String
9596
9656
  }
9597
9657
 
9598
- type ApiToken {
9599
- """Unique identifier for the token"""
9600
- id: String!
9601
- """JWT to be passed into the Authorization header for API requests"""
9602
- token: String!
9603
- """ISO time string for the expiry of the token"""
9604
- expiresTimeString: String!
9605
- """Number of root fields this api token is allowed to resolve before it's rate limited"""
9606
- requestLimit: String!
9607
- """Approximate number of remaining resolutions before this token is rate limited"""
9608
- remaining: String
9658
+ """Community notes data."""
9659
+ type CommunityNotesResponse {
9660
+ """The list of community notes matching the filter parameters."""
9661
+ items: [CommunityNote!]!
9662
+ """The number of community notes returned."""
9663
+ count: Int!
9664
+ """A cursor for use in pagination."""
9665
+ cursor: String
9609
9666
  }
9610
9667
 
9611
- input CreateApiTokensInput {
9612
- """Number of tokens to create, default is 1"""
9613
- count: Int
9614
- """Number of requests allowed per token, represented as a string, default is 5000"""
9615
- requestLimit: String
9616
- """Number of milliseconds until the token expires, defaults to 1 hour (3600000)"""
9617
- expiresIn: Int
9668
+ """Metadata for a wallet label from the WALLET_LABEL_TYPES vocabulary"""
9669
+ type WalletLabelType {
9670
+ """Label name (e.g. WHALE, CEX, KOL)"""
9671
+ name: String!
9672
+ """Human-readable display name"""
9673
+ displayName: String!
9674
+ """Description of what this label means"""
9675
+ description: String!
9618
9676
  }
9619
9677
 
9620
9678
  """The quote token within the pair."""
@@ -9638,6 +9696,16 @@ type ExplorerConfig {
9638
9696
  url: String!
9639
9697
  }
9640
9698
 
9699
+ """The native currency of an EVM network: the precision of native balances and gas, and, where the chain exposes the same funds through an ERC-20 interface, that alias contract and the system contract that emits its transfer logs. Absent for networks whose native asset has no such alias."""
9700
+ type NativeCurrency {
9701
+ """Decimals of native balances and gas amounts."""
9702
+ decimals: Int!
9703
+ """ERC-20 contract that is another interface to the same native funds, not a wrapper."""
9704
+ erc20AliasAddress: String
9705
+ """System contract that emits the canonical transfer logs for native movements."""
9706
+ transferEventEmitter: String
9707
+ }
9708
+
9641
9709
  interface NetworkConfigBase {
9642
9710
  id: ID!
9643
9711
  networkId: Int!
@@ -9822,11 +9890,11 @@ input MarketCapEventWebhookConditionInput {
9822
9890
  fdvMarketCapUsd: ComparisonOperatorInput
9823
9891
  """The circulating market cap conditions to listen for."""
9824
9892
  circulatingMarketCapUsd: ComparisonOperatorInput
9825
- """The contract address of the pair to listen for."""
9826
- pairAddress: StringEqualsConditionInput
9827
- """The volume conditions to listen for."""
9893
+ """No longer supported: market cap webhooks evaluate the token's price, the one the API reports. Creating a webhook with this field fails."""
9894
+ pairAddress: StringEqualsConditionInput @deprecated(reason: "Market cap webhooks evaluate the token's price; setting this field is rejected.")
9895
+ """The token 24h volume conditions to listen for."""
9828
9896
  volumeUsd: ComparisonOperatorInput
9829
- """The liquidity conditions to listen for."""
9897
+ """The token liquidity conditions to listen for."""
9830
9898
  liquidityUsd: ComparisonOperatorInput
9831
9899
  }
9832
9900
 
@@ -10388,15 +10456,15 @@ type MarketCapEventWebhookCondition {
10388
10456
  tokenAddress: StringEqualsCondition!
10389
10457
  """The network ID the webhook is listening on."""
10390
10458
  networkId: IntEqualsCondition!
10391
- """The market cap condition that must be met in order for the webhook to send."""
10459
+ """The market cap condition that must be met in order for the webhook to send. Market cap uses the token price the API reports."""
10392
10460
  fdvMarketCapUsd: ComparisonOperator
10393
- """The circulating market cap condition that must be met in order for the webhook to send."""
10461
+ """The circulating market cap condition that must be met in order for the webhook to send. Market cap uses the token price the API reports."""
10394
10462
  circulatingMarketCapUsd: ComparisonOperator
10395
- """The pair contract address the webhook is listening for."""
10396
- pairAddress: StringEqualsCondition
10397
- """The liquidity condition (for the source pair) that must be met in order for the webhook to send."""
10463
+ """The pair contract address set on older webhooks. Ignored: market cap webhooks evaluate the token's price."""
10464
+ pairAddress: StringEqualsCondition @deprecated(reason: "Market cap webhooks evaluate the token's price; this field is ignored.")
10465
+ """The token liquidity condition that must be met in order for the webhook to send."""
10398
10466
  liquidityUsd: ComparisonOperator
10399
- """The volume condition (for the source pair) that must be met in order for the webhook to send."""
10467
+ """The token 24h volume condition that must be met in order for the webhook to send."""
10400
10468
  volumeUsd: ComparisonOperator
10401
10469
  }
10402
10470
 
@@ -10667,8 +10735,10 @@ type WalletFilterResult {
10667
10735
  lastTransactionAt: Int!
10668
10736
  """The labels associated with the wallet"""
10669
10737
  labels: [String!]!
10670
- """Manual or proposal-derived identity vocabulary (e.g. WHALE, KOL). Distinct from behavioral `labels`."""
10738
+ """Labels on the wallet's profile: identity (e.g. WHALE, KOL) and the behaviour our labelling jobs write (BOT, SCAMMER, VOLUME_BOT). See [`WalletLabel`](/api-reference/enums/walletlabel)."""
10671
10739
  identityLabels: [String!]
10740
+ """Registry entity ids of the apps this wallet trades through — e.g. `defined` for defined.fi, or `axiom`. Means "trades through", never "is owned by": one routed trade is enough to appear here."""
10741
+ tradeSourceIds: [String!]
10672
10742
  """Volume in USD in the past day"""
10673
10743
  volumeUsd1d: String!
10674
10744
  """Total volume in USD in the past day including all tokens"""
@@ -10879,16 +10949,16 @@ enum EventType {
10879
10949
  LiquidityLock
10880
10950
  }
10881
10951
 
10882
- """The commitment level of a streamed event - only Solana and Base support values other than Confirmed. Processed returns Base Flashblocks. Preprocessed is Solana-only."""
10952
+ """The commitment level of a streamed event - only Solana and Base support values other than Confirmed. Processed returns Base Flashblocks. Preprocessed is Solana-only and deprecated because edge node performance improvements have made it unnecessary. Use Processed instead."""
10883
10953
  enum EventCommitmentLevel {
10884
- Preprocessed
10954
+ Preprocessed @deprecated(reason: "Edge node performance improvements have made Preprocessed unnecessary. Use Processed instead.")
10885
10955
  Processed
10886
10956
  Confirmed
10887
10957
  }
10888
10958
 
10889
- """The commitment level of a streamed bar update - only Solana and Base support values other than Confirmed. Processed returns Base Flashblocks. Preprocessed is Solana-only."""
10959
+ """The commitment level of a streamed bar update - only Solana and Base support values other than Confirmed. Processed returns Base Flashblocks. Preprocessed is Solana-only and deprecated because edge node performance improvements have made it unnecessary. Use Processed instead."""
10890
10960
  enum BarCommitmentLevel {
10891
- Preprocessed
10961
+ Preprocessed @deprecated(reason: "Edge node performance improvements have made Preprocessed unnecessary. Use Processed instead.")
10892
10962
  Processed
10893
10963
  Confirmed
10894
10964
  }
@@ -10906,6 +10976,12 @@ enum EventDisplayType {
10906
10976
 
10907
10977
  """The attribute used to rank tokens."""
10908
10978
  enum PairRankingAttribute {
10979
+ """The pool's static fee rate. Pools with no static rate have no value and sort last."""
10980
+ poolFeeBps
10981
+ """Weighted risk score of the pair's token of interest."""
10982
+ riskScore
10983
+ """Unix seconds of the token's latest recorded risk change."""
10984
+ riskFlaggedAt
10909
10985
  createdAt
10910
10986
  lastTransaction
10911
10987
  buyCount1
@@ -11002,48 +11078,59 @@ enum LaunchpadRankingAttribute {
11002
11078
  volume4
11003
11079
  volume12
11004
11080
  volume24
11081
+ volume1w
11005
11082
  buyVolume1
11006
11083
  buyVolume4
11007
11084
  buyVolume12
11008
11085
  buyVolume24
11086
+ buyVolume1w
11009
11087
  sellVolume1
11010
11088
  sellVolume4
11011
11089
  sellVolume12
11012
11090
  sellVolume24
11091
+ sellVolume1w
11013
11092
  volumeChange1
11014
11093
  volumeChange4
11015
11094
  volumeChange12
11016
11095
  volumeChange24
11096
+ volumeChange1w
11017
11097
  transactions1
11018
11098
  transactions4
11019
11099
  transactions12
11020
11100
  transactions24
11101
+ transactions1w
11021
11102
  buys1
11022
11103
  buys4
11023
11104
  buys12
11024
11105
  buys24
11106
+ buys1w
11025
11107
  sells1
11026
11108
  sells4
11027
11109
  sells12
11028
11110
  sells24
11111
+ sells1w
11029
11112
  activeTokens1
11030
11113
  activeTokens4
11031
11114
  activeTokens12
11032
11115
  activeTokens24
11116
+ activeTokens1w
11033
11117
  liquidity
11034
11118
  marketCap
11035
11119
  poolFees1
11036
11120
  poolFees4
11037
11121
  poolFees12
11038
11122
  poolFees24
11123
+ poolFees1w
11039
11124
  totalFees1
11040
11125
  totalFees4
11041
11126
  totalFees12
11042
11127
  totalFees24
11128
+ totalFees1w
11043
11129
  feeToVolumeRatio1
11044
11130
  feeToVolumeRatio4
11045
11131
  feeToVolumeRatio12
11046
11132
  feeToVolumeRatio24
11133
+ feeToVolumeRatio1w
11047
11134
  timestamp
11048
11135
  tokensTotal
11049
11136
  tokensCompletedTotal
@@ -11115,12 +11202,24 @@ enum TokenPairStatisticsType {
11115
11202
  enum PotentialScamReason {
11116
11203
  """The token does not meet the minimum liquidity threshold."""
11117
11204
  MinimumLiquidity
11205
+ """Liquidity could not be read, so the liquidity checks did not run."""
11206
+ LiquidityUnknown
11118
11207
  """The token has experienced a significant drop in liquidity."""
11119
11208
  LiquidityRugPull
11120
11209
  """The token has suspicious wallet activity."""
11121
11210
  SuspiciousWalletActivity
11122
11211
  """The token has an abnormal buyer ratio."""
11123
11212
  AbnormalBuyerRatio
11213
+ """The creator wallet holds at least half of the supply."""
11214
+ DevConcentration
11215
+ """Wallets that bought within seconds of launch hold at least half of the supply."""
11216
+ SniperConcentration
11217
+ """The token graduated its launchpad in its creation slot and the launch shape is corroborated by a creator distribution, holders that never traded, bot churn, one-way flow, a thin pool or a bot-only market."""
11218
+ BundledLaunch
11219
+ """A launchpad token whose market is a pool on a venue the launchpad does not migrate to, opened within minutes of the mint."""
11220
+ ForeignVenueLaunch
11221
+ """Hundreds of buyers, a few dozen sellers doing every sell, buy and sell volume matched, almost nobody holding: supply cycled through hub wallets."""
11222
+ SellerHub
11124
11223
  }
11125
11224
 
11126
11225
  input OnPricesUpdatedInput {
@@ -11187,6 +11286,8 @@ input EventsQueryInput {
11187
11286
  priceUsdTotal: NumberFilter
11188
11287
  """Specify the type of symbol you want to fetch values for (TOKEN | POOL)"""
11189
11288
  symbolType: SymbolType
11289
+ """When `true`, return the token's latest events across ALL of its pools instead of only its top pool. Requires `symbolType: TOKEN`, rejects `quoteToken`, and issues cursors that are not interchangeable with top-pool cursors. Slower. Available on the DEFINED plan only. Defaults to `false`."""
11290
+ crossPools: Boolean
11190
11291
  }
11191
11292
 
11192
11293
  input MakerEventsQueryInput {
@@ -11247,7 +11348,7 @@ input BalancesInput {
11247
11348
  networks: [Int!]
11248
11349
  """The token IDs (`address:networkId`) or addresses to request the balance for. Requires a list of `networks` if only passing addresses. Include native network balances using `native` as the token address. Only applied when using `walletAddress` (not `walletId`). Max 200 tokens."""
11249
11350
  tokens: [String!]
11250
- """Whether to include native network balances in the response (ID will be native:<networkId>). Requires a list of `networks`. Does not apply when using `tokens`."""
11351
+ """Whether to include native network balances in the response (ID will be native:<networkId>). Requires a list of `networks`. Does not apply when using `tokens`. On networks where the native asset is also readable through an ERC-20 alias contract, the response counts that holding once: the native view is returned and the alias projection row is suppressed on every page; request the alias contract explicitly in `tokens`, or set `includeNative: false`, for the contract view."""
11251
11352
  includeNative: Boolean
11252
11353
  """The maximum number of holdings to return. Does not apply when using `tokens`."""
11253
11354
  limit: Int
@@ -11295,12 +11396,18 @@ type Balance {
11295
11396
  updatedAtBlock: Int
11296
11397
  """Metadata for the token."""
11297
11398
  token: EnhancedToken
11298
- """The token's route-backed liquidity in USD: the real liquidity supporting the token price, summed across the token's pairs with valid routing liquidity. Quote assets (a network's base token and stablecoins) have no route of their own, so they report pool liquidity instead. Null when this stat has not been computed for the token yet."""
11399
+ """The token's liquidity in USD. On networks where the real-money total is enabled, this is `totalLiquidityUsd` from `filterTokens`: the combined liquidity of its 15 deepest pools, leaving out pools with no trade in the last 7 days, where each pool counts only the real money the token can reach in one or two trades into the network's pricing reference tokens (such as its main stablecoins), with each route counted once. Elsewhere, or until that total is computed for the token, it is the token's route-backed liquidity, summed across its pairs with valid routing liquidity; quote assets (a network's base token and stablecoins) have no route of their own, so they report pool liquidity instead. Null when this stat has not been computed for the token yet."""
11299
11400
  liquidityUsd: String
11300
11401
  """Unix timestamp (seconds) of the token's most recent trade/market event across all pools we track. Token-level (not specific to this wallet). Useful for filtering out dead/worthless tokens, e.g. no activity in months."""
11301
11402
  tokenLastTradedTimestamp: Int
11302
11403
  """Identity and profile metadata for the wallet holding this balance. Not always available."""
11303
11404
  wallet: Wallet
11405
+ """The economic asset this balance is a view of (`tokenAddress:networkId`). On networks where one holding is readable through a native interface and an ERC-20 alias contract, both views share this id. Null elsewhere."""
11406
+ assetId: String
11407
+ """The number of decimals `balance` is expressed in for this view. A native view reports the native precision (18 on such networks); a contract view reports the alias contract's decimals (6). `token.decimals` remains the contract's metadata. Null elsewhere."""
11408
+ balanceDecimals: Int
11409
+ """True when this row is the ERC-20 alias projection (a same-block floor of the native holding, in `balanceDecimals`) rather than the authoritative native view; false for the native view. Null elsewhere."""
11410
+ isBalanceAlias: Boolean
11304
11411
  }
11305
11412
 
11306
11413
  """Response returned by `holders`."""
@@ -11531,7 +11638,7 @@ type AssetDeployment {
11531
11638
  assetId: String!
11532
11639
  """The Grid root ID for the parent organization."""
11533
11640
  rootId: String!
11534
- """The enhanced token this deployment represents."""
11641
+ """The enhanced token this deployment represents. Its `asset` and `organization` are always null, so deployments cannot be traversed recursively."""
11535
11642
  token: EnhancedToken
11536
11643
  }
11537
11644
 
@@ -12072,6 +12179,8 @@ type LaunchpadStats {
12072
12179
  volume12: String
12073
12180
  """The trade volume in USD in the past 24 hours."""
12074
12181
  volume24: String
12182
+ """The trade volume in USD in the past week."""
12183
+ volume1w: String
12075
12184
  """The buy volume in USD in the past hour."""
12076
12185
  buyVolume1: String
12077
12186
  """The buy volume in USD in the past 4 hours."""
@@ -12080,6 +12189,8 @@ type LaunchpadStats {
12080
12189
  buyVolume12: String
12081
12190
  """The buy volume in USD in the past 24 hours."""
12082
12191
  buyVolume24: String
12192
+ """The buy volume in USD in the past week."""
12193
+ buyVolume1w: String
12083
12194
  """The sell volume in USD in the past hour."""
12084
12195
  sellVolume1: String
12085
12196
  """The sell volume in USD in the past 4 hours."""
@@ -12088,6 +12199,8 @@ type LaunchpadStats {
12088
12199
  sellVolume12: String
12089
12200
  """The sell volume in USD in the past 24 hours."""
12090
12201
  sellVolume24: String
12202
+ """The sell volume in USD in the past week."""
12203
+ sellVolume1w: String
12091
12204
  """The percent volume change in the past hour. Decimal format."""
12092
12205
  volumeChange1: Float
12093
12206
  """The percent volume change in the past 4 hours. Decimal format."""
@@ -12096,6 +12209,8 @@ type LaunchpadStats {
12096
12209
  volumeChange12: Float
12097
12210
  """The percent volume change in the past 24 hours. Decimal format."""
12098
12211
  volumeChange24: Float
12212
+ """The percent volume change in the past week. Decimal format."""
12213
+ volumeChange1w: Float
12099
12214
  """The number of transactions in the past hour."""
12100
12215
  transactions1: Int
12101
12216
  """The number of transactions in the past 4 hours."""
@@ -12104,6 +12219,8 @@ type LaunchpadStats {
12104
12219
  transactions12: Int
12105
12220
  """The number of transactions in the past 24 hours."""
12106
12221
  transactions24: Int
12222
+ """The number of transactions in the past week."""
12223
+ transactions1w: Int
12107
12224
  """The number of buys in the past hour."""
12108
12225
  buys1: Int
12109
12226
  """The number of buys in the past 4 hours."""
@@ -12112,6 +12229,8 @@ type LaunchpadStats {
12112
12229
  buys12: Int
12113
12230
  """The number of buys in the past 24 hours."""
12114
12231
  buys24: Int
12232
+ """The number of buys in the past week."""
12233
+ buys1w: Int
12115
12234
  """The number of sells in the past hour."""
12116
12235
  sells1: Int
12117
12236
  """The number of sells in the past 4 hours."""
@@ -12120,6 +12239,8 @@ type LaunchpadStats {
12120
12239
  sells12: Int
12121
12240
  """The number of sells in the past 24 hours."""
12122
12241
  sells24: Int
12242
+ """The number of sells in the past week."""
12243
+ sells1w: Int
12123
12244
  """The number of tokens with trading activity in the past hour."""
12124
12245
  activeTokens1: Int
12125
12246
  """The number of tokens with trading activity in the past 4 hours."""
@@ -12128,6 +12249,8 @@ type LaunchpadStats {
12128
12249
  activeTokens12: Int
12129
12250
  """The number of tokens with trading activity in the past 24 hours."""
12130
12251
  activeTokens24: Int
12252
+ """The number of tokens with trading activity in the past week."""
12253
+ activeTokens1w: Int
12131
12254
  """The total liquidity in USD."""
12132
12255
  liquidity: String
12133
12256
  """The total market cap in USD."""
@@ -12140,6 +12263,8 @@ type LaunchpadStats {
12140
12263
  poolFees12: String
12141
12264
  """The pool fees in USD in the past 24 hours. Null when the launchpad has no fee data."""
12142
12265
  poolFees24: String
12266
+ """The pool fees in USD in the past week. Null when the launchpad has no fee data."""
12267
+ poolFees1w: String
12143
12268
  """The total fees in USD in the past hour. Null when the launchpad has no fee data."""
12144
12269
  totalFees1: String
12145
12270
  """The total fees in USD in the past 4 hours. Null when the launchpad has no fee data."""
@@ -12148,6 +12273,8 @@ type LaunchpadStats {
12148
12273
  totalFees12: String
12149
12274
  """The total fees in USD in the past 24 hours. Null when the launchpad has no fee data."""
12150
12275
  totalFees24: String
12276
+ """The total fees in USD in the past week. Null when the launchpad has no fee data."""
12277
+ totalFees1w: String
12151
12278
  """The ratio of fees to volume in the past hour. Null when the window has no fee data or no volume."""
12152
12279
  feeToVolumeRatio1: Float
12153
12280
  """The ratio of fees to volume in the past 4 hours. Null when the window has no fee data or no volume."""
@@ -12156,6 +12283,8 @@ type LaunchpadStats {
12156
12283
  feeToVolumeRatio12: Float
12157
12284
  """The ratio of fees to volume in the past 24 hours. Null when the window has no fee data or no volume."""
12158
12285
  feeToVolumeRatio24: Float
12286
+ """The ratio of fees to volume in the past week. Null when the window has no fee data or no volume."""
12287
+ feeToVolumeRatio1w: Float
12159
12288
  }
12160
12289
 
12161
12290
  """A launchpad matching a set of filter parameters. Combined stats across all of the launchpad's tokens are at the root; `pre` and `post` break the same stats down by migration phase."""
@@ -12238,6 +12367,8 @@ type LaunchpadFilterResult {
12238
12367
  volume12: String
12239
12368
  """The trade volume in USD in the past 24 hours."""
12240
12369
  volume24: String
12370
+ """The trade volume in USD in the past week."""
12371
+ volume1w: String
12241
12372
  """The buy volume in USD in the past hour."""
12242
12373
  buyVolume1: String
12243
12374
  """The buy volume in USD in the past 4 hours."""
@@ -12246,6 +12377,8 @@ type LaunchpadFilterResult {
12246
12377
  buyVolume12: String
12247
12378
  """The buy volume in USD in the past 24 hours."""
12248
12379
  buyVolume24: String
12380
+ """The buy volume in USD in the past week."""
12381
+ buyVolume1w: String
12249
12382
  """The sell volume in USD in the past hour."""
12250
12383
  sellVolume1: String
12251
12384
  """The sell volume in USD in the past 4 hours."""
@@ -12254,6 +12387,8 @@ type LaunchpadFilterResult {
12254
12387
  sellVolume12: String
12255
12388
  """The sell volume in USD in the past 24 hours."""
12256
12389
  sellVolume24: String
12390
+ """The sell volume in USD in the past week."""
12391
+ sellVolume1w: String
12257
12392
  """The percent volume change in the past hour. Decimal format."""
12258
12393
  volumeChange1: Float
12259
12394
  """The percent volume change in the past 4 hours. Decimal format."""
@@ -12262,6 +12397,8 @@ type LaunchpadFilterResult {
12262
12397
  volumeChange12: Float
12263
12398
  """The percent volume change in the past 24 hours. Decimal format."""
12264
12399
  volumeChange24: Float
12400
+ """The percent volume change in the past week. Decimal format."""
12401
+ volumeChange1w: Float
12265
12402
  """The number of transactions in the past hour."""
12266
12403
  transactions1: Int
12267
12404
  """The number of transactions in the past 4 hours."""
@@ -12270,6 +12407,8 @@ type LaunchpadFilterResult {
12270
12407
  transactions12: Int
12271
12408
  """The number of transactions in the past 24 hours."""
12272
12409
  transactions24: Int
12410
+ """The number of transactions in the past week."""
12411
+ transactions1w: Int
12273
12412
  """The number of buys in the past hour."""
12274
12413
  buys1: Int
12275
12414
  """The number of buys in the past 4 hours."""
@@ -12278,6 +12417,8 @@ type LaunchpadFilterResult {
12278
12417
  buys12: Int
12279
12418
  """The number of buys in the past 24 hours."""
12280
12419
  buys24: Int
12420
+ """The number of buys in the past week."""
12421
+ buys1w: Int
12281
12422
  """The number of sells in the past hour."""
12282
12423
  sells1: Int
12283
12424
  """The number of sells in the past 4 hours."""
@@ -12286,6 +12427,8 @@ type LaunchpadFilterResult {
12286
12427
  sells12: Int
12287
12428
  """The number of sells in the past 24 hours."""
12288
12429
  sells24: Int
12430
+ """The number of sells in the past week."""
12431
+ sells1w: Int
12289
12432
  """The number of tokens with trading activity in the past hour."""
12290
12433
  activeTokens1: Int
12291
12434
  """The number of tokens with trading activity in the past 4 hours."""
@@ -12294,6 +12437,8 @@ type LaunchpadFilterResult {
12294
12437
  activeTokens12: Int
12295
12438
  """The number of tokens with trading activity in the past 24 hours."""
12296
12439
  activeTokens24: Int
12440
+ """The number of tokens with trading activity in the past week."""
12441
+ activeTokens1w: Int
12297
12442
  """The total liquidity in USD."""
12298
12443
  liquidity: String
12299
12444
  """The total market cap in USD."""
@@ -12306,6 +12451,8 @@ type LaunchpadFilterResult {
12306
12451
  poolFees12: String
12307
12452
  """The pool fees in USD in the past 24 hours. Null when the launchpad has no fee data."""
12308
12453
  poolFees24: String
12454
+ """The pool fees in USD in the past week. Null when the launchpad has no fee data."""
12455
+ poolFees1w: String
12309
12456
  """The total fees in USD in the past hour. Null when the launchpad has no fee data."""
12310
12457
  totalFees1: String
12311
12458
  """The total fees in USD in the past 4 hours. Null when the launchpad has no fee data."""
@@ -12314,6 +12461,8 @@ type LaunchpadFilterResult {
12314
12461
  totalFees12: String
12315
12462
  """The total fees in USD in the past 24 hours. Null when the launchpad has no fee data."""
12316
12463
  totalFees24: String
12464
+ """The total fees in USD in the past week. Null when the launchpad has no fee data."""
12465
+ totalFees1w: String
12317
12466
  """The ratio of fees to volume in the past hour. Null when the window has no fee data or no volume."""
12318
12467
  feeToVolumeRatio1: Float
12319
12468
  """The ratio of fees to volume in the past 4 hours. Null when the window has no fee data or no volume."""
@@ -12322,6 +12471,8 @@ type LaunchpadFilterResult {
12322
12471
  feeToVolumeRatio12: Float
12323
12472
  """The ratio of fees to volume in the past 24 hours. Null when the window has no fee data or no volume."""
12324
12473
  feeToVolumeRatio24: Float
12474
+ """The ratio of fees to volume in the past week. Null when the window has no fee data or no volume."""
12475
+ feeToVolumeRatio1w: Float
12325
12476
  """Stats for tokens still on the bonding curve."""
12326
12477
  pre: LaunchpadStats
12327
12478
  """Stats for tokens that have migrated."""
@@ -12532,6 +12683,22 @@ type PairFilterResult {
12532
12683
  swapPct7dOldWallet: String
12533
12684
  """The reasons the token has been flagged as a potential scam."""
12534
12685
  potentialScamReasons: [PotentialScamReason]
12686
+ """The pool's static fee rate in basis points (1 bps = 0.01%), normalized across protocols. Null when the pool has no comparable static rate, including when a hook sets the fee per swap."""
12687
+ poolFeeBps: Float
12688
+ """Whether a hook or plugin sets the fee per swap rather than the pool charging a static rate. Null for protocols that do not report it."""
12689
+ dynamicFee: Boolean
12690
+ """Codex's risk verdict for the pair: the token's verdict, or `SCAM` when this pair's own pool is a proven trap (the pool's hook refuses or underpays sells the token itself allows). Not a safety guarantee — read `riskCoverage` first. Null when unassessed."""
12691
+ riskVerdict: RiskVerdict
12692
+ """Weighted risk score from 0 to 100. Null for a terminal verdict reached without scoring, and when unassessed. Not a probability."""
12693
+ riskScore: Float
12694
+ """Unix seconds when the engine last recorded a change to this token's risk. Null when the token has never been assessed."""
12695
+ riskFlaggedAt: Int
12696
+ """Unix seconds of the contract analysis `riskVerdict` rests on: the decisive analysis, or the newest reading of a proven trapped pool. Null when neither stands behind it."""
12697
+ riskAnalyzedAt: Int
12698
+ """How much contract analysis stood behind `riskVerdict`. Describes what was looked at, not what was concluded."""
12699
+ riskCoverage: RiskAnalysisCoverage
12700
+ """The reason codes behind `riskVerdict`, unordered. New codes are added over time, so do not assume this list is exhaustive."""
12701
+ riskReasons: [RiskReasonCode!]
12535
12702
  }
12536
12703
 
12537
12704
  """The app a trade was placed through — a trading terminal, wallet, or interface — as distinct from the exchange it settled on."""
@@ -12733,11 +12900,70 @@ input TokenCategoryFilter {
12733
12900
  hasCategory: Boolean
12734
12901
  }
12735
12902
 
12903
+ """A social link a token can have."""
12904
+ enum TokenSocialLink {
12905
+ BITCOINTALK
12906
+ BLOG
12907
+ COINGECKO
12908
+ COINMARKETCAP
12909
+ DISCORD
12910
+ EMAIL
12911
+ FACEBOOK
12912
+ GITHUB
12913
+ INSTAGRAM
12914
+ LINKEDIN
12915
+ REDDIT
12916
+ SLACK
12917
+ TELEGRAM
12918
+ TWITCH
12919
+ TWITTER
12920
+ WEBSITE
12921
+ WECHAT
12922
+ WHITEPAPER
12923
+ YOUTUBE
12924
+ }
12925
+
12926
+ """Media a token can have."""
12927
+ enum TokenMediaType {
12928
+ """A token logo (thumbnail, small or large image)."""
12929
+ LOGO
12930
+ """A banner image."""
12931
+ BANNER
12932
+ """A video."""
12933
+ VIDEO
12934
+ }
12935
+
12936
+ input TokenSocialFilter {
12937
+ """Match tokens with any of these social links (OR)."""
12938
+ anyOf: [TokenSocialLink!]
12939
+ """Match tokens with all of these social links (AND)."""
12940
+ allOf: [TokenSocialLink!]
12941
+ """Exclude tokens with any of these social links."""
12942
+ noneOf: [TokenSocialLink!]
12943
+ """Match tokens that have at least one social link (true) or none (false)."""
12944
+ hasAny: Boolean
12945
+ }
12946
+
12947
+ input TokenMediaFilter {
12948
+ """Match tokens with any of these media types (OR)."""
12949
+ anyOf: [TokenMediaType!]
12950
+ """Match tokens with all of these media types (AND)."""
12951
+ allOf: [TokenMediaType!]
12952
+ """Exclude tokens with any of these media types."""
12953
+ noneOf: [TokenMediaType!]
12954
+ """Match tokens that have at least one media type (true) or none (false)."""
12955
+ hasAny: Boolean
12956
+ }
12957
+
12736
12958
  """Input type of `TokenFilters`."""
12737
12959
  input TokenFilters {
12738
12960
  """Recursive boolean expression for combining token filters."""
12739
12961
  boolFilter: TokenBoolFilter
12740
12962
  categories: TokenCategoryFilter
12963
+ """Filter by the token's social links (contributed or provider-sourced). Grid organization links are not counted."""
12964
+ socials: TokenSocialFilter
12965
+ """Filter by the token's logo, banner and video. Grid images are not counted."""
12966
+ media: TokenMediaFilter
12741
12967
  """The unix timestamp for the creation of the token's first pair."""
12742
12968
  createdAt: NumberFilter
12743
12969
  """The unix timestamp for the creation of the token."""
@@ -12790,9 +13016,9 @@ input TokenFilters {
12790
13016
  high24: NumberFilter
12791
13017
  """The highest price in USD in the past 4 hours."""
12792
13018
  high4: NumberFilter
12793
- """The amount of liquidity in the token's top pair."""
13019
+ """The amount of liquidity in the token's top pair. With `useAggregatedStats`, on networks where the real-money total is enabled, this filters on the same value as `totalLiquidityUsd` once the token has one; on other networks it filters on the token's aggregated liquidity."""
12794
13020
  liquidity: NumberFilter
12795
- """The token's cumulative route-backed liquidity in USD, summed across the token's pairs with valid routing liquidity. Distinct from `liquidity`, which covers the top pair only."""
13021
+ """The token's total liquidity in USD: the combined liquidity of its 15 deepest pools, leaving out pools with no trade in the last 7 days. On networks where the real-money total is enabled, each pool counts only the real money behind it: what the token can reach in one or two trades into the network's pricing reference tokens (such as its main stablecoins), with each route counted once. Distinct from `liquidity`, which covers the top pair only, except with `useAggregatedStats` on networks where the real-money total is enabled, where the two are the same value."""
12796
13022
  totalLiquidityUsd: NumberFilter
12797
13023
  """The lowest price in USD in the past hour."""
12798
13024
  low1: NumberFilter
@@ -12910,7 +13136,7 @@ input TokenFilters {
12910
13136
  creatorAddresses: [String!]
12911
13137
  """A list of launchpad protocols."""
12912
13138
  launchpadProtocol: [String!]
12913
- """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, pons, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, UniswapCCA, tren.ch, StonkFun."""
13139
+ """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel."""
12914
13140
  launchpadName: [String!]
12915
13141
  """Indicates if the launchpad is completed."""
12916
13142
  launchpadCompleted: Boolean
@@ -12982,6 +13208,16 @@ input TokenFilters {
12982
13208
  hasGridData: Boolean
12983
13209
  """Filter by Grid bluechip ratings. Returns tokens matching any of the provided ratings."""
12984
13210
  bluechipRatings: [String!]
13211
+ """Filter by risk verdict. Returns tokens matching any of the provided verdicts."""
13212
+ riskVerdicts: [RiskVerdict!]
13213
+ """Filter by how much contract analysis stood behind the verdict."""
13214
+ riskCoverages: [RiskAnalysisCoverage!]
13215
+ """Filter by risk reason codes. Returns tokens where any of the provided reasons fired."""
13216
+ riskReasons: [RiskReasonCode!]
13217
+ """Filter by weighted risk score."""
13218
+ riskScore: NumberFilter
13219
+ """Filter by when the engine last recorded a change to the risk assessment, in Unix seconds."""
13220
+ riskFlaggedAt: NumberFilter
12985
13221
  """Filter by all-time high price."""
12986
13222
  athPrice: NumberFilter
12987
13223
  """Filter by all-time low price."""
@@ -13149,6 +13385,99 @@ type TokenWithMetadata {
13149
13385
  lastTransaction: Int
13150
13386
  }
13151
13387
 
13388
+ """Codex's unified risk assessment for a token. `verdict` is not a safety guarantee. `VERIFIED` means a human marked the token not-a-scam — a moderator judgement, not an allowlist — and `NEUTRAL` means the weighted score is below the caution threshold. Reasons can still be present on a neutral assessment. Neither says a token is safe to trade, and a clean assessment cannot see an un-armed trap (owner-pausable, blacklist-after-N-txs, upgradeable proxy). Read `coverage` before trusting anything else: `NOT_ANALYZED` means no contract analysis stands behind this verdict. Null fields indicate unavailable or inapplicable results as described below; they never mean "safe"."""
13389
+ type TokenRisk {
13390
+ """The verdict. Null when the token has not been assessed."""
13391
+ verdict: RiskVerdict
13392
+ """Weighted score from 0 to 100, computed from weighted signals with family caps and a corroboration bonus, then clamped. Null for a terminal verdict reached without scoring, and for an unassessed token. Not a probability."""
13393
+ score: Float
13394
+ """Unix seconds when the engine last recorded a change to this token's risk assessment, the first recorded observation included. A re-evaluation that reaches the same result records nothing, so this tracks change rather than evaluation. Null when the token has never been assessed."""
13395
+ flaggedAt: Int
13396
+ """Unix seconds of the contract analysis the verdict rests on: the decisive analysis, or the newest reading of a proven trapped pool. Moves only when the contract is probed again, unlike `flaggedAt`. Null when neither stands behind the verdict."""
13397
+ analyzedAt: Int
13398
+ """How much contract analysis stood behind the verdict. Null when unassessed, or when a terminal verdict was reached without establishing analysis coverage."""
13399
+ coverage: RiskAnalysisCoverage
13400
+ """The reason codes behind the verdict, unordered. Empty when nothing fired; null when unassessed. New codes are added over time, so do not assume this list is exhaustive or that a familiar set is the whole picture."""
13401
+ reasons: [RiskReasonCode!]
13402
+ }
13403
+
13404
+ """A token's risk verdict. These values are not an ordered safety scale: `SCAM` and `VERIFIED` are terminal states reached by mechanical proof or a human decision, while `HIGH_RISK`, `CAUTION` and `NEUTRAL` are graded outcomes of weighted signals."""
13405
+ enum RiskVerdict {
13406
+ """Proven a scam by mechanical evidence, or labelled one by a human."""
13407
+ SCAM
13408
+ """The weighted score reached the high-risk threshold."""
13409
+ HIGH_RISK
13410
+ """The weighted score reached the caution threshold but remains below high risk."""
13411
+ CAUTION
13412
+ """The weighted score is below the caution threshold. Reasons may still be present. Not a statement that the token is safe."""
13413
+ NEUTRAL
13414
+ """A human marked this token not-a-scam. A moderator judgement, not an allowlist."""
13415
+ VERIFIED
13416
+ """Marked not-a-scam by a human, but mechanical signals disagree."""
13417
+ VERIFIED_CONTESTED
13418
+ }
13419
+
13420
+ """How much contract analysis stood behind a verdict. This describes what was looked at, not what was concluded — `ANALYZED` does not mean a token is safe. New values may be added over time, so treat one you do not recognize as unknown."""
13421
+ enum RiskAnalysisCoverage {
13422
+ """No contract analysis stands behind this assessment."""
13423
+ NOT_ANALYZED
13424
+ """Analysis ran but reached no decisive verdict."""
13425
+ INCONCLUSIVE
13426
+ """Analysis ran and reached a decisive verdict, or proved a pool of the token is a trap."""
13427
+ ANALYZED
13428
+ """The verdict rests on a tradeable analysis more than seven days old. A contract can change after it was probed. A honeypot proof never becomes stale."""
13429
+ STALE
13430
+ }
13431
+
13432
+ """The reasons a risk verdict can cite. This vocabulary grows over time. Treat the list on a token as the reasons Codex can name today, not as a complete account of everything wrong with it."""
13433
+ enum RiskReasonCode {
13434
+ PROOF_HONEYPOT_SIM
13435
+ PROOF_NON_TRANSFERABLE
13436
+ PROOF_TRANSFER_FEE_100
13437
+ PROOF_PAUSED
13438
+ PROOF_DEFAULT_FROZEN
13439
+ PROOF_RUG_OCCURRED
13440
+ PROOF_POOL_TRAP_SIM
13441
+ AUTH_MINT
13442
+ AUTH_FREEZE
13443
+ AUTH_PERMANENT_DELEGATE
13444
+ AUTH_TRANSFER_HOOK
13445
+ AUTH_PAUSABLE
13446
+ AUTH_OWNER_NOT_RENOUNCED
13447
+ AUTH_CAN_TRANSFER_OWNERSHIP
13448
+ TAX_BUY_HIGH
13449
+ TAX_SELL_HIGH
13450
+ TAX_HONEYPOT_UNCONFIRMED
13451
+ TAX_PAUSED
13452
+ TAX_POOL_TRAP
13453
+ TAX_POOL_TRAP_HOOK_SHARED
13454
+ LIQ_MINIMAL
13455
+ LIQ_UNKNOWN
13456
+ LIQ_RUG_CLIFF
13457
+ LIQ_UNLOCKED
13458
+ LIQ_DRAINING
13459
+ HOLD_TOP10_CONCENTRATED
13460
+ HOLD_DEV_HEAVY
13461
+ HOLD_SNIPER_HEAVY
13462
+ HOLD_BUNDLER_HEAVY
13463
+ HOLD_INSIDER_HEAVY
13464
+ """The creator of a launchpad token sold or handed off a large share of supply in the token's first hour."""
13465
+ HOLD_INSIDER_DUMPED
13466
+ FLOW_ONE_WAY
13467
+ FLOW_WALLET_FARM
13468
+ FLOW_WASH_DOMINATED
13469
+ FLOW_BUNDLED_LAUNCH
13470
+ FLOW_MECHANICAL_TRADING
13471
+ FLOW_RING_DOMINATED
13472
+ REP_SERIAL_RUGGER
13473
+ REP_RISKY_CREATOR
13474
+ REP_SCAMMER_FUNDED
13475
+ REP_IMITATOR_SYMBOL
13476
+ REP_IMITATOR_NAME
13477
+ LABEL_MANUAL_SCAM
13478
+ LABEL_VERIFIED
13479
+ }
13480
+
13152
13481
  """Custom metadata sourced from a token standard's on-chain metadata mechanism — currently the ERC-7572 `contractURI()` fields used by Base B20 tokens."""
13153
13482
  type Erc7572CustomInfo {
13154
13483
  """Token-standard discriminant for this custom data (currently always `erc7572`)."""
@@ -13164,6 +13493,36 @@ type TokenExtensions {
13164
13493
  token2022: Token2022Extensions
13165
13494
  """Base B20 extension metadata."""
13166
13495
  b20: B20Extensions
13496
+ """Robinhood Chain stock token (tokenized equity) metadata."""
13497
+ robinhoodStockToken: RobinhoodStockTokenExtensions
13498
+ """xStocks (Backed Finance tokenized equity) metadata, on EVM networks. Solana xStocks use `token2022.scaledUiAmountConfig`."""
13499
+ xStock: XStockTokenExtensions
13500
+ }
13501
+
13502
+ type XStockTokenExtensions {
13503
+ """Multiplier in effect now, as a decimal string (e.g. "1.0017"). It grows as dividends are reinvested and jumps on a split. xStocks rebase: balances and transfer amounts already include it, so divide by it to get the token's internal shares. Already reflects `newMultiplier` once `newMultiplierEffectiveAt` has passed."""
13504
+ multiplier: String
13505
+ """Unix-seconds timestamp when the multiplier was last read from chain by us."""
13506
+ multiplierObservedAt: String
13507
+ """Scheduled multiplier, as a decimal string. Stays set after it takes effect until our next read from chain."""
13508
+ newMultiplier: String
13509
+ """Unix-seconds timestamp when `newMultiplier` takes effect."""
13510
+ newMultiplierEffectiveAt: String
13511
+ }
13512
+
13513
+ type RobinhoodStockTokenExtensions {
13514
+ """Robinhood's cross-chain asset id for the underlying equity."""
13515
+ uid: String!
13516
+ """Multiplier in effect now, as a decimal string (e.g. "4.0" after a 4:1 split). Already reflects `newMultiplier` once `newMultiplierEffectiveAt` has passed."""
13517
+ multiplier: String
13518
+ """Unix-seconds timestamp when the multiplier was last read from chain by us."""
13519
+ multiplierObservedAt: String
13520
+ """Multiplier scheduled by a corporate action, as a decimal string. Stays set after it takes effect until our next read from chain."""
13521
+ newMultiplier: String
13522
+ """Unix-seconds timestamp when `newMultiplier` takes effect."""
13523
+ newMultiplierEffectiveAt: String
13524
+ """Whether the token's price oracle is paused."""
13525
+ oraclePaused: Boolean
13167
13526
  }
13168
13527
 
13169
13528
  type B20Extensions {
@@ -13184,6 +13543,26 @@ type B20Extensions {
13184
13543
  type Token2022Extensions {
13185
13544
  """Scaled UI amount configuration for Token-2022 mints."""
13186
13545
  scaledUiAmountConfig: Token2022ScaledUiAmountConfig
13546
+ """Transfer fee schedules and authority for Token-2022 mints."""
13547
+ transferFeeConfig: Token2022TransferFeeConfig
13548
+ }
13549
+
13550
+ type Token2022TransferFeeConfig {
13551
+ """Authority allowed to update transfer fees; null when revoked."""
13552
+ transferFeeConfigAuthority: String
13553
+ """Schedule used before newerTransferFee.epoch."""
13554
+ olderTransferFee: Token2022TransferFee!
13555
+ """Schedule used from newerTransferFee.epoch onwards."""
13556
+ newerTransferFee: Token2022TransferFee!
13557
+ }
13558
+
13559
+ type Token2022TransferFee {
13560
+ """First epoch this schedule applies, as a decimal string."""
13561
+ epoch: String!
13562
+ """Fee in basis points (100 basis points = 1%)."""
13563
+ transferFeeBasisPoints: Int!
13564
+ """Maximum fee in raw token units, before decimal adjustment."""
13565
+ maximumFee: String!
13187
13566
  }
13188
13567
 
13189
13568
  type Token2022ScaledUiAmountConfig {
@@ -13262,9 +13641,12 @@ input GetPriceInput {
13262
13641
  maxDeviations: Float @deprecated(reason: "This isn't taken into account anymore.")
13263
13642
  }
13264
13643
 
13644
+ """The pooled amounts of a pair's two tokens."""
13265
13645
  type PooledTokenValues {
13266
13646
  token0: String
13267
13647
  token1: String
13648
+ """True when this pool's reserves are not known, in which case `token0` and `token1` read `0` and are not real amounts. False for every pool whose reserves are known, including one that is genuinely empty."""
13649
+ invalidReserves: Boolean!
13268
13650
  }
13269
13651
 
13270
13652
  """Input type of `getTokensInfo`."""
@@ -13461,6 +13843,20 @@ input PairFilters {
13461
13843
  isTestnet: Boolean
13462
13844
  """The address of the hook contract for applicable protocols."""
13463
13845
  hookAddress: [String]
13846
+ """The pool's static fee rate in basis points (1 bps = 0.01%), normalized across protocols that each store it differently. Pools with no comparable static rate are not matched by any range here, including pools whose fee a hook sets per swap — filter those with `dynamicFee`."""
13847
+ poolFeeBps: NumberFilter
13848
+ """Whether a hook or plugin sets the fee per swap rather than the pool charging a static rate. Such pools have no `poolFeeBps`, so no range on it will return them. Only set for protocols that report it, so `false` does not describe every other pool."""
13849
+ dynamicFee: Boolean
13850
+ """Filter by the risk verdict of the pair's token of interest. Returns pairs matching any of the provided verdicts."""
13851
+ riskVerdicts: [RiskVerdict!]
13852
+ """Filter by how much contract analysis stood behind the verdict."""
13853
+ riskCoverages: [RiskAnalysisCoverage!]
13854
+ """Filter by risk reason codes. Returns pairs where any of the provided reasons fired."""
13855
+ riskReasons: [RiskReasonCode!]
13856
+ """Filter by weighted risk score."""
13857
+ riskScore: NumberFilter
13858
+ """Filter by when the engine last recorded a change to the risk assessment, in Unix seconds."""
13859
+ riskFlaggedAt: NumberFilter
13464
13860
  """The average age of the wallets that traded in the last 24h"""
13465
13861
  walletAgeAvg: NumberFilter
13466
13862
  """The standard deviation of age of the wallets that traded in the last 24h"""
@@ -13519,6 +13915,8 @@ input LaunchpadStatsFilters {
13519
13915
  volume12: NumberFilter
13520
13916
  """The trade volume in USD in the past 24 hours."""
13521
13917
  volume24: NumberFilter
13918
+ """The trade volume in USD in the past week."""
13919
+ volume1w: NumberFilter
13522
13920
  """The buy volume in USD in the past hour."""
13523
13921
  buyVolume1: NumberFilter
13524
13922
  """The buy volume in USD in the past 4 hours."""
@@ -13527,6 +13925,8 @@ input LaunchpadStatsFilters {
13527
13925
  buyVolume12: NumberFilter
13528
13926
  """The buy volume in USD in the past 24 hours."""
13529
13927
  buyVolume24: NumberFilter
13928
+ """The buy volume in USD in the past week."""
13929
+ buyVolume1w: NumberFilter
13530
13930
  """The sell volume in USD in the past hour."""
13531
13931
  sellVolume1: NumberFilter
13532
13932
  """The sell volume in USD in the past 4 hours."""
@@ -13535,6 +13935,8 @@ input LaunchpadStatsFilters {
13535
13935
  sellVolume12: NumberFilter
13536
13936
  """The sell volume in USD in the past 24 hours."""
13537
13937
  sellVolume24: NumberFilter
13938
+ """The sell volume in USD in the past week."""
13939
+ sellVolume1w: NumberFilter
13538
13940
  """The percent volume change in the past hour. Decimal format."""
13539
13941
  volumeChange1: NumberFilter
13540
13942
  """The percent volume change in the past 4 hours. Decimal format."""
@@ -13543,6 +13945,8 @@ input LaunchpadStatsFilters {
13543
13945
  volumeChange12: NumberFilter
13544
13946
  """The percent volume change in the past 24 hours. Decimal format."""
13545
13947
  volumeChange24: NumberFilter
13948
+ """The percent volume change in the past week. Decimal format."""
13949
+ volumeChange1w: NumberFilter
13546
13950
  """The number of transactions in the past hour."""
13547
13951
  transactions1: NumberFilter
13548
13952
  """The number of transactions in the past 4 hours."""
@@ -13551,6 +13955,8 @@ input LaunchpadStatsFilters {
13551
13955
  transactions12: NumberFilter
13552
13956
  """The number of transactions in the past 24 hours."""
13553
13957
  transactions24: NumberFilter
13958
+ """The number of transactions in the past week."""
13959
+ transactions1w: NumberFilter
13554
13960
  """The number of buys in the past hour."""
13555
13961
  buys1: NumberFilter
13556
13962
  """The number of buys in the past 4 hours."""
@@ -13559,6 +13965,8 @@ input LaunchpadStatsFilters {
13559
13965
  buys12: NumberFilter
13560
13966
  """The number of buys in the past 24 hours."""
13561
13967
  buys24: NumberFilter
13968
+ """The number of buys in the past week."""
13969
+ buys1w: NumberFilter
13562
13970
  """The number of sells in the past hour."""
13563
13971
  sells1: NumberFilter
13564
13972
  """The number of sells in the past 4 hours."""
@@ -13567,6 +13975,8 @@ input LaunchpadStatsFilters {
13567
13975
  sells12: NumberFilter
13568
13976
  """The number of sells in the past 24 hours."""
13569
13977
  sells24: NumberFilter
13978
+ """The number of sells in the past week."""
13979
+ sells1w: NumberFilter
13570
13980
  """The number of tokens with trading activity in the past hour."""
13571
13981
  activeTokens1: NumberFilter
13572
13982
  """The number of tokens with trading activity in the past 4 hours."""
@@ -13575,6 +13985,8 @@ input LaunchpadStatsFilters {
13575
13985
  activeTokens12: NumberFilter
13576
13986
  """The number of tokens with trading activity in the past 24 hours."""
13577
13987
  activeTokens24: NumberFilter
13988
+ """The number of tokens with trading activity in the past week."""
13989
+ activeTokens1w: NumberFilter
13578
13990
  """The total liquidity in USD."""
13579
13991
  liquidity: NumberFilter
13580
13992
  """The total market cap in USD."""
@@ -13587,6 +13999,8 @@ input LaunchpadStatsFilters {
13587
13999
  poolFees12: NumberFilter
13588
14000
  """The pool fees in USD in the past 24 hours. Null when the launchpad has no fee data."""
13589
14001
  poolFees24: NumberFilter
14002
+ """The pool fees in USD in the past week. Null when the launchpad has no fee data."""
14003
+ poolFees1w: NumberFilter
13590
14004
  """The total fees in USD in the past hour. Null when the launchpad has no fee data."""
13591
14005
  totalFees1: NumberFilter
13592
14006
  """The total fees in USD in the past 4 hours. Null when the launchpad has no fee data."""
@@ -13595,6 +14009,8 @@ input LaunchpadStatsFilters {
13595
14009
  totalFees12: NumberFilter
13596
14010
  """The total fees in USD in the past 24 hours. Null when the launchpad has no fee data."""
13597
14011
  totalFees24: NumberFilter
14012
+ """The total fees in USD in the past week. Null when the launchpad has no fee data."""
14013
+ totalFees1w: NumberFilter
13598
14014
  """The ratio of fees to volume in the past hour. Null when the window has no fee data or no volume."""
13599
14015
  feeToVolumeRatio1: NumberFilter
13600
14016
  """The ratio of fees to volume in the past 4 hours. Null when the window has no fee data or no volume."""
@@ -13603,6 +14019,8 @@ input LaunchpadStatsFilters {
13603
14019
  feeToVolumeRatio12: NumberFilter
13604
14020
  """The ratio of fees to volume in the past 24 hours. Null when the window has no fee data or no volume."""
13605
14021
  feeToVolumeRatio24: NumberFilter
14022
+ """The ratio of fees to volume in the past week. Null when the window has no fee data or no volume."""
14023
+ feeToVolumeRatio1w: NumberFilter
13606
14024
  }
13607
14025
 
13608
14026
  """Input type of `filterLaunchpads`. Numeric filters apply to the combined stats at the root; use `pre`/`post` for phase-level stats filters."""
@@ -13667,6 +14085,8 @@ input LaunchpadFilters {
13667
14085
  volume12: NumberFilter
13668
14086
  """The trade volume in USD in the past 24 hours."""
13669
14087
  volume24: NumberFilter
14088
+ """The trade volume in USD in the past week."""
14089
+ volume1w: NumberFilter
13670
14090
  """The buy volume in USD in the past hour."""
13671
14091
  buyVolume1: NumberFilter
13672
14092
  """The buy volume in USD in the past 4 hours."""
@@ -13675,6 +14095,8 @@ input LaunchpadFilters {
13675
14095
  buyVolume12: NumberFilter
13676
14096
  """The buy volume in USD in the past 24 hours."""
13677
14097
  buyVolume24: NumberFilter
14098
+ """The buy volume in USD in the past week."""
14099
+ buyVolume1w: NumberFilter
13678
14100
  """The sell volume in USD in the past hour."""
13679
14101
  sellVolume1: NumberFilter
13680
14102
  """The sell volume in USD in the past 4 hours."""
@@ -13683,6 +14105,8 @@ input LaunchpadFilters {
13683
14105
  sellVolume12: NumberFilter
13684
14106
  """The sell volume in USD in the past 24 hours."""
13685
14107
  sellVolume24: NumberFilter
14108
+ """The sell volume in USD in the past week."""
14109
+ sellVolume1w: NumberFilter
13686
14110
  """The percent volume change in the past hour. Decimal format."""
13687
14111
  volumeChange1: NumberFilter
13688
14112
  """The percent volume change in the past 4 hours. Decimal format."""
@@ -13691,6 +14115,8 @@ input LaunchpadFilters {
13691
14115
  volumeChange12: NumberFilter
13692
14116
  """The percent volume change in the past 24 hours. Decimal format."""
13693
14117
  volumeChange24: NumberFilter
14118
+ """The percent volume change in the past week. Decimal format."""
14119
+ volumeChange1w: NumberFilter
13694
14120
  """The number of transactions in the past hour."""
13695
14121
  transactions1: NumberFilter
13696
14122
  """The number of transactions in the past 4 hours."""
@@ -13699,6 +14125,8 @@ input LaunchpadFilters {
13699
14125
  transactions12: NumberFilter
13700
14126
  """The number of transactions in the past 24 hours."""
13701
14127
  transactions24: NumberFilter
14128
+ """The number of transactions in the past week."""
14129
+ transactions1w: NumberFilter
13702
14130
  """The number of buys in the past hour."""
13703
14131
  buys1: NumberFilter
13704
14132
  """The number of buys in the past 4 hours."""
@@ -13707,6 +14135,8 @@ input LaunchpadFilters {
13707
14135
  buys12: NumberFilter
13708
14136
  """The number of buys in the past 24 hours."""
13709
14137
  buys24: NumberFilter
14138
+ """The number of buys in the past week."""
14139
+ buys1w: NumberFilter
13710
14140
  """The number of sells in the past hour."""
13711
14141
  sells1: NumberFilter
13712
14142
  """The number of sells in the past 4 hours."""
@@ -13715,6 +14145,8 @@ input LaunchpadFilters {
13715
14145
  sells12: NumberFilter
13716
14146
  """The number of sells in the past 24 hours."""
13717
14147
  sells24: NumberFilter
14148
+ """The number of sells in the past week."""
14149
+ sells1w: NumberFilter
13718
14150
  """The number of tokens with trading activity in the past hour."""
13719
14151
  activeTokens1: NumberFilter
13720
14152
  """The number of tokens with trading activity in the past 4 hours."""
@@ -13723,6 +14155,8 @@ input LaunchpadFilters {
13723
14155
  activeTokens12: NumberFilter
13724
14156
  """The number of tokens with trading activity in the past 24 hours."""
13725
14157
  activeTokens24: NumberFilter
14158
+ """The number of tokens with trading activity in the past week."""
14159
+ activeTokens1w: NumberFilter
13726
14160
  """The total liquidity in USD."""
13727
14161
  liquidity: NumberFilter
13728
14162
  """The total market cap in USD."""
@@ -13735,6 +14169,8 @@ input LaunchpadFilters {
13735
14169
  poolFees12: NumberFilter
13736
14170
  """The pool fees in USD in the past 24 hours. Null when the launchpad has no fee data."""
13737
14171
  poolFees24: NumberFilter
14172
+ """The pool fees in USD in the past week. Null when the launchpad has no fee data."""
14173
+ poolFees1w: NumberFilter
13738
14174
  """The total fees in USD in the past hour. Null when the launchpad has no fee data."""
13739
14175
  totalFees1: NumberFilter
13740
14176
  """The total fees in USD in the past 4 hours. Null when the launchpad has no fee data."""
@@ -13743,6 +14179,8 @@ input LaunchpadFilters {
13743
14179
  totalFees12: NumberFilter
13744
14180
  """The total fees in USD in the past 24 hours. Null when the launchpad has no fee data."""
13745
14181
  totalFees24: NumberFilter
14182
+ """The total fees in USD in the past week. Null when the launchpad has no fee data."""
14183
+ totalFees1w: NumberFilter
13746
14184
  """The ratio of fees to volume in the past hour. Null when the window has no fee data or no volume."""
13747
14185
  feeToVolumeRatio1: NumberFilter
13748
14186
  """The ratio of fees to volume in the past 4 hours. Null when the window has no fee data or no volume."""
@@ -13751,6 +14189,8 @@ input LaunchpadFilters {
13751
14189
  feeToVolumeRatio12: NumberFilter
13752
14190
  """The ratio of fees to volume in the past 24 hours. Null when the window has no fee data or no volume."""
13753
14191
  feeToVolumeRatio24: NumberFilter
14192
+ """The ratio of fees to volume in the past week. Null when the window has no fee data or no volume."""
14193
+ feeToVolumeRatio1w: NumberFilter
13754
14194
  """Phase-level stats filters for tokens still on the bonding curve."""
13755
14195
  pre: LaunchpadStatsFilters
13756
14196
  """Phase-level stats filters for tokens that have migrated."""
@@ -13864,6 +14304,10 @@ type EventFeeData {
13864
14304
  priorityFeeNativeUnit: String
13865
14305
  """Gas units consumed by the transaction (EVM gas units or Solana compute units)."""
13866
14306
  gasUsed: String
14307
+ """Which pool slot (0 or 1) `poolFeeAmountRaw` is denominated in, when the pool's slots are not measured in the same currency (e.g. a native slot); null otherwise."""
14308
+ poolFeeCurrencyIndex: Int
14309
+ """Which pool slot (0 or 1) the protocol fee amount is denominated in, when the pool's slots are not measured in the same currency; null otherwise."""
14310
+ protocolFeeCurrencyIndex: Int
13867
14311
  """Direct payment to the block builder in native token smallest unit. Sum of ETH transfers to block.coinbase on EVM, or Jito tip on Solana."""
13868
14312
  builderTipNativeUnit: String
13869
14313
  """L1 data posting fee in native token smallest unit (L2 rollups only: Base, Optimism, etc.)."""
@@ -13894,8 +14338,54 @@ type PumpAmmCashbackFeeData {
13894
14338
  cashbackAmountLamports: String!
13895
14339
  }
13896
14340
 
14341
+ """Realized Lift harvest payouts on the zero-liquidity V3 Burn fee poke; not an extra trading fee. Amounts are raw units."""
14342
+ type LiftHarvestFeeData {
14343
+ """Discriminant for the SupplementalFeeData union."""
14344
+ type: String!
14345
+ """The Lift NFT position the harvest was collected from."""
14346
+ positionId: String!
14347
+ """The quote token the payouts are denominated in."""
14348
+ quoteAddress: String!
14349
+ """The launch creator paid by the harvest, when known."""
14350
+ creatorAddress: String
14351
+ """Raw quote paid to the creator."""
14352
+ quoteToCreator: String!
14353
+ """Raw quote paid to the Lift treasury."""
14354
+ quoteToTreasury: String!
14355
+ """Raw launched-token amount burned by the harvest."""
14356
+ baseBurned: String!
14357
+ }
14358
+
14359
+ """Distribution of previously accrued Tolly fees, attached only to a V3 Collect. Amounts are raw ERC-20 units."""
14360
+ type TollyCollectionFeeData {
14361
+ """Discriminant for the SupplementalFeeData union."""
14362
+ type: String!
14363
+ """The Tolly NFT position the fees were collected from."""
14364
+ positionId: String!
14365
+ """The launched project token."""
14366
+ projectToken: String!
14367
+ """Raw quote collected."""
14368
+ quoteCollectedRaw: String!
14369
+ """Raw project token burned."""
14370
+ tokenBurnedRaw: String!
14371
+ """Raw quote used for the Tolly buyback."""
14372
+ tollyBuybackRaw: String!
14373
+ """Raw quote used for the project buyback."""
14374
+ projectBuybackRaw: String!
14375
+ """Raw quote accrued toward the project buyback."""
14376
+ projectBuybackAccruedRaw: String!
14377
+ """Raw quote distributed to holders."""
14378
+ holderRewardsRaw: String!
14379
+ """Raw quote paid to the protocol."""
14380
+ protocolRaw: String!
14381
+ """Raw quote paid to the creator."""
14382
+ creatorPaidRaw: String!
14383
+ """Raw quote accrued to the creator."""
14384
+ creatorAccruedRaw: String!
14385
+ }
14386
+
13897
14387
  """Protocol-specific supplemental fee data."""
13898
- union SupplementalFeeData = PumpCashbackFeeData | PumpAmmCashbackFeeData
14388
+ union SupplementalFeeData = PumpCashbackFeeData | PumpAmmCashbackFeeData | LiftHarvestFeeData | TollyCollectionFeeData
13899
14389
 
13900
14390
  """Event labels. Can be `sandwich` or `washtrade`."""
13901
14391
  type LabelsForEvent {
@@ -14065,6 +14555,8 @@ type PairMetadata {
14065
14555
  createdAt: Int
14066
14556
  """The percentage of total supply held by the top 10 holders."""
14067
14557
  top10HoldersPercent: Float
14558
+ """The measurement units the pool's reserves (`token0.pooled`, `token1.pooled`) were shifted by; null when the pool measures in its tokens' metadata (`token0.decimals`, `token1.decimals`)."""
14559
+ currencyUnits: CurrencyUnits
14068
14560
  }
14069
14561
 
14070
14562
  """Response returned by `listPairsWithMetadataForToken`."""
@@ -14103,6 +14595,8 @@ type UniswapV4Data {
14103
14595
  isToken0NetworkToken: Boolean
14104
14596
  """Whether the pool uses a dynamic fee. A fee of 0x80000 is used by Uniswap V4 to indicate a dynamic pool -- in such cases, the fee percentage on the pair should be disregarded."""
14105
14597
  isDynamicFee: Boolean
14598
+ """The measurement units of the pool's slots, when they differ from the tokens' metadata."""
14599
+ currencyUnits: CurrencyUnits
14106
14600
  type: String!
14107
14601
  }
14108
14602
 
@@ -14120,6 +14614,18 @@ type PumpData {
14120
14614
 
14121
14615
  union ProtocolData = UniswapV4Data | ArenaTradeData | PumpData
14122
14616
 
14617
+ """The measurement units of a pool's two slots. Present only for a pool whose raw side amounts are not measured in its tokens' contract metadata (for example a native-currency slot); null for every other pool, whose raw amounts follow `token0Data.decimals` / `token1Data.decimals`. `Token.decimals` is always the contract's metadata."""
14618
+ type CurrencyUnits {
14619
+ """The original on-chain currency of slot 0 (a native slot keeps its zero address)."""
14620
+ currency0: String!
14621
+ """The original on-chain currency of slot 1."""
14622
+ currency1: String!
14623
+ """The decimals raw slot-0 amounts, reserves and prices are measured in."""
14624
+ decimals0: Int!
14625
+ """The decimals raw slot-1 amounts, reserves and prices are measured in."""
14626
+ decimals1: Int!
14627
+ }
14628
+
14123
14629
  """Metadata for a token pair."""
14124
14630
  type Pair {
14125
14631
  """The contract address of the pair."""
@@ -14150,6 +14656,8 @@ type Pair {
14150
14656
  pooled: PooledTokenValues
14151
14657
  """The virtual pooled amounts of each token in the pair."""
14152
14658
  virtualPooled: PooledTokenValues
14659
+ """The measurement units of this pool's raw side amounts and reserves; null when the pool measures in its tokens' metadata."""
14660
+ currencyUnits: CurrencyUnits
14153
14661
  """Custom data for the pair, only certain protocols have this. (uniswapv4, arenatrade for example)"""
14154
14662
  protocolData: ProtocolData
14155
14663
  """The per-protocol data for the pair, if applicable"""
@@ -14188,6 +14696,280 @@ input TokenSparklineInput {
14188
14696
  fillMissingBars: Boolean
14189
14697
  }
14190
14698
 
14699
+ """A page of recorded analysis results returned by `getSimulateTokenContractResults`."""
14700
+ type GetSimulateTokenContractResultsConnection {
14701
+ """The recorded analyses in this page."""
14702
+ results: [SimulateTokenContractResult!]!
14703
+ """Opaque pagination cursor. Pass as cursor on the next query; null when no further page is available."""
14704
+ cursor: String
14705
+ }
14706
+
14707
+ """Error codes for a token contract buy/sell."""
14708
+ enum SimulateTokenContractBuySellErrorEnum {
14709
+ INSUFFICIENT_OUTPUT_AMOUNT
14710
+ INSUFFICIENT_LIQUIDITY
14711
+ TRANSFER_FAILED
14712
+ UNKNOWN_ERROR
14713
+ }
14714
+
14715
+ """Analysis pipeline status. SUCCESS means processing completed, including honeypot and indeterminate outcomes; inspect verdict for the finding. FAILURE means processing failed, and PENDING means the request is awaiting a recorded outcome."""
14716
+ enum SimulateTokenContractResultStatusEnum {
14717
+ SUCCESS
14718
+ FAILURE
14719
+ PENDING
14720
+ }
14721
+
14722
+ """Verdict of a completed analysis, orthogonal to status (the pipeline lifecycle). TRADEABLE / HONEYPOT are decisive; INDETERMINATE means the analysis ran but couldn't reach a decisive verdict (no/low liquidity, unswappable/unsupported venue, no native route, timeout) — see verdictReason."""
14723
+ enum AnalysisVerdictEnum {
14724
+ TRADEABLE
14725
+ HONEYPOT
14726
+ INDETERMINATE
14727
+ }
14728
+
14729
+ """Errors for a token contract buy/sell."""
14730
+ type SimulateTokenContractErrors {
14731
+ simulatorError: String
14732
+ tokenErrors: SimulateTokenErrorsType!
14733
+ deployErrors: SimulateDeployErrorsType!
14734
+ contractBalanceErrors: SimulateContractBalanceErrorsType!
14735
+ liquidityErrors: SimulateLiquidityErrorsType!
14736
+ transferErrors: SimulateTransferErrorsType!
14737
+ swapErrors: SimulateSwapErrorsType!
14738
+ ownerErrors: SimulateOwnerErrorsType!
14739
+ creatorErrors: SimulateCreatorErrorsType!
14740
+ }
14741
+
14742
+ """A recorded token analysis. Inspect verdict rather than status or individual swap flags to interpret the outcome. Nullable measurements can be unavailable, unsupported or not attempted; null does not mean zero or safe. Legacy rows may omit verdict."""
14743
+ type SimulateTokenContractResult {
14744
+ id: String!
14745
+ sortKey: String!
14746
+ contractHashKey: String!
14747
+ uuidHashKey: String!
14748
+ """Recorded analysis block number, encoded as a string. An empty string indicates an unavailable block number."""
14749
+ blockNumber: String!
14750
+ networkId: Int!
14751
+ """Analysis input mode: 0 for deployment input, 1 for creation transaction, and 2 for a live contract."""
14752
+ analysisType: Int!
14753
+ """Unix timestamp in seconds recorded when the analysis request was created."""
14754
+ timestamp: Int!
14755
+ status: SimulateTokenContractResultStatusEnum!
14756
+ """Analysis verdict (orthogonal to status). Null on legacy rows written before verdicts existed."""
14757
+ verdict: AnalysisVerdictEnum
14758
+ """Human-readable reason a verdict is INDETERMINATE (e.g. low/no liquidity). Null otherwise."""
14759
+ verdictReason: String
14760
+ errors: SimulateTokenContractErrors!
14761
+ """The simulationId returned when the request was submitted."""
14762
+ uuid: String!
14763
+ token: SimulateTokenType!
14764
+ deploy: SimulateDeployType!
14765
+ contractBalance: SimulateContractBalanceType!
14766
+ liquidity: SimulateLiquidityType!
14767
+ transfer: SimulateTransferType!
14768
+ swap: SimulateSwapType!
14769
+ owner: SimulateOwnerType!
14770
+ creator: SimulateCreatorType!
14771
+ }
14772
+
14773
+ """Result of a token contract deploy."""
14774
+ type SimulateDeployType {
14775
+ deploySuccess: Boolean
14776
+ """Legacy simulation: tokens minted to the deployer in decimal-adjusted token units. Check deployErrors because zero can also accompany a failed measurement."""
14777
+ tokenMintedToDeployer: String
14778
+ }
14779
+
14780
+ """Errors for a token contract deploy."""
14781
+ type SimulateDeployErrorsType {
14782
+ deployError: String
14783
+ tokenMintedToDeployerError: String
14784
+ }
14785
+
14786
+ """Result of a token contract liquidity."""
14787
+ type SimulateLiquidityType {
14788
+ """Trading pool identifier, when available. Usually an address; Uniswap V4 results can contain a 32-byte pool ID. Null when no single pool is reported."""
14789
+ pairAddress: String
14790
+ """Liquidity-token supply in raw liquidity-token units. Null when unavailable."""
14791
+ lpTotalSupply: String
14792
+ preLiquidityEnableTradingCall: String
14793
+ preLiquidityEnableTradingSuccess: Boolean
14794
+ preLiquidityEnableTradingSupportsTransfer: Boolean
14795
+ liquiditySetByPreLiquidityOpenTradingCall: Boolean
14796
+ postLiquidityEnableTradingCall: String
14797
+ postLiquidityEnableTradingSuccess: Boolean
14798
+ addLiquiditySuccess: Boolean
14799
+ }
14800
+
14801
+ """Errors for a token contract liquidity."""
14802
+ type SimulateLiquidityErrorsType {
14803
+ lpTotalSupplyError: String
14804
+ preLiquidityEnableTradingError: String
14805
+ postLiquidityEnableTradingError: String
14806
+ addLiquidityError: String
14807
+ }
14808
+
14809
+ """Result of a token contract transfer."""
14810
+ type SimulateTransferType {
14811
+ tokenContractApprovalSuccess: Boolean
14812
+ tokenTransferredToContractSuccess: Boolean
14813
+ userApprovalSuccess: Boolean
14814
+ }
14815
+
14816
+ """Errors for a token contract transfer."""
14817
+ type SimulateTransferErrorsType {
14818
+ tokenContractApprovalError: String
14819
+ tokenTransferredToContractError: String
14820
+ userApprovalError: String
14821
+ }
14822
+
14823
+ """Result of a token contract swap."""
14824
+ type SimulateSwapType {
14825
+ """Buy outcome inferred from recorded errors. Do not use this flag alone: pending or incomplete records may have no errors. Inspect verdict and status."""
14826
+ buySuccess: Boolean
14827
+ """Current analyzer: buy tax as a decimal fraction encoded as a string (0.05 means 5%). Legacy simulation rows used percentage values and a different sign convention; values are returned without normalization. Null when unavailable."""
14828
+ buyTax: String
14829
+ """Gas units consumed by the simulated buy, encoded as an integer string. Null when not recorded."""
14830
+ buyGasUsed: String
14831
+ """Legacy detected buy limit in decimal-adjusted token units. Null when a limit was not recorded; this does not prove unrestricted buying."""
14832
+ maxBuyAmount: String
14833
+ """Sell outcome inferred from recorded errors. Do not use this flag alone: pending or incomplete records may have no errors. Inspect verdict and status."""
14834
+ sellSuccess: Boolean
14835
+ """Current analyzer: sell tax as a decimal fraction encoded as a string (0.05 means 5%). Legacy simulation rows used percentage values and a different sign convention; values are returned without normalization. Null when unavailable."""
14836
+ sellTax: String
14837
+ """Gas units consumed by the simulated sell, encoded as an integer string. Null when not recorded."""
14838
+ sellGasUsed: String
14839
+ """Current analyzer: detected sell limit in raw token units. Legacy simulations used decimal-adjusted token units. Null when a limit was not recorded; this does not prove unrestricted selling."""
14840
+ maxSellAmount: String
14841
+ }
14842
+
14843
+ """Errors for a token contract swap."""
14844
+ type SimulateSwapErrorsType {
14845
+ buyError: String
14846
+ buyErrorEnum: SimulateTokenContractBuySellErrorEnum
14847
+ sellError: String
14848
+ sellErrorEnum: SimulateTokenContractBuySellErrorEnum
14849
+ }
14850
+
14851
+ """Result of a token contract."""
14852
+ type SimulateTokenType {
14853
+ contractAddress: String!
14854
+ tokenSymbol: String
14855
+ decimals: Int
14856
+ tokenName: String
14857
+ """Token supply in raw token units, encoded as an integer string. Divide by 10^decimals for whole tokens. Null when unavailable."""
14858
+ totalSupply: String
14859
+ canTransferOwnership: Boolean
14860
+ canRenounceOwnership: Boolean
14861
+ isOwnerRenounced: Boolean
14862
+ }
14863
+
14864
+ """Errors for a token contract."""
14865
+ type SimulateTokenErrorsType {
14866
+ tokenSymbolError: String
14867
+ decimalsError: String
14868
+ tokenNameError: String
14869
+ totalSupplyError: String
14870
+ canTransferOwnershipError: String
14871
+ canRenounceOwnershipError: String
14872
+ }
14873
+
14874
+ """Result of a token contract owner."""
14875
+ type SimulateOwnerType {
14876
+ ownerAddress: String
14877
+ """Token balance in raw token units, encoded as an integer string. Null when not measured."""
14878
+ ownerTokenBalance: String
14879
+ """Native-currency balance in wei for EVM analysis, encoded as an integer string. Null when not measured."""
14880
+ ownerEthBalance: String
14881
+ }
14882
+
14883
+ """Errors for a token contract owner."""
14884
+ type SimulateOwnerErrorsType {
14885
+ ownerAddressError: String
14886
+ ownerTokenBalanceError: String
14887
+ ownerEthBalanceError: String
14888
+ }
14889
+
14890
+ """Result of a token contract balance."""
14891
+ type SimulateContractBalanceType {
14892
+ """Token balance in raw token units, encoded as an integer string. Null when not measured."""
14893
+ tokenContractTokenBalance: String
14894
+ """Native-currency balance in wei for EVM analysis, encoded as an integer string. Null when not measured."""
14895
+ tokenContractEthBalance: String
14896
+ }
14897
+
14898
+ """Errors for a token contract balance."""
14899
+ type SimulateContractBalanceErrorsType {
14900
+ tokenContractTokenBalanceError: String
14901
+ tokenContractEthBalanceError: String
14902
+ }
14903
+
14904
+ """Result of a token contract creator."""
14905
+ type SimulateCreatorType {
14906
+ creatorAddress: String
14907
+ """Token balance in raw token units, encoded as an integer string. Null when not measured."""
14908
+ creatorTokenBalance: String
14909
+ """Native-currency balance in wei for EVM analysis, encoded as an integer string. Null when not measured."""
14910
+ creatorEthBalance: String
14911
+ }
14912
+
14913
+ """Errors for a token contract creator."""
14914
+ type SimulateCreatorErrorsType {
14915
+ creatorTokenBalanceError: String
14916
+ creatorEthBalanceError: String
14917
+ }
14918
+
14919
+ """Response returned by `simulateTokenContract`."""
14920
+ type SimulateTokenContractResponse {
14921
+ """Whether the request was queued and its pending record saved. This does not indicate analysis completion or token safety."""
14922
+ result: Boolean!
14923
+ """The request identifier. Match it against a result uuid, or pass it to getSimulateTokenContractResults."""
14924
+ simulationId: String
14925
+ """Submission failure message when result is false. Cooldown errors are returned as GraphQL errors instead."""
14926
+ error: String
14927
+ }
14928
+
14929
+ """Legacy deployment simulation input. The current analyzer records a failure for this mode."""
14930
+ input SimulateDeployInput {
14931
+ """The network ID of the token. Analysis availability depends on the network and supported trading venues."""
14932
+ networkId: Int!
14933
+ """The block number to simulate the contract at."""
14934
+ blockNumber: Int!
14935
+ """The contract address of the token."""
14936
+ contractAddress: String!
14937
+ """The contract creation transaction input to simulate."""
14938
+ contractInput: String!
14939
+ }
14940
+
14941
+ """Legacy creation-transaction simulation input. The current analyzer records a failure for this mode."""
14942
+ input SimulateCreateTransactionInput {
14943
+ """The network ID of the token. Analysis availability depends on the network and supported trading venues."""
14944
+ networkId: Int!
14945
+ """The block number to simulate the contract at."""
14946
+ blockNumber: Int!
14947
+ """The contract creation transaction hash from the live network."""
14948
+ createTransactionHash: String!
14949
+ """The contract address of the token."""
14950
+ contractAddress: String!
14951
+ }
14952
+
14953
+ """Input type of `simulateTokenContract`."""
14954
+ input SimulateLiveContractInput {
14955
+ """The network ID of the token. Analysis availability depends on the network and supported trading venues."""
14956
+ networkId: Int!
14957
+ """Requested block number. When omitted, submission derives a recent block from indexed data and fails if none is available. The current live analyzer probes latest state rather than replaying this block."""
14958
+ blockNumber: Int
14959
+ """The contract address of the token."""
14960
+ contractAddress: String!
14961
+ }
14962
+
14963
+ """Provide one input mode. Use simulateLiveContractInput for the current analyzer. Legacy modes remain for compatibility. If several are supplied, the resolver selects deployment, then live contract, then creation transaction; no mode returns result: false."""
14964
+ input SimulateTokenContractInput {
14965
+ """Input for a token contract deploy simulation."""
14966
+ simulateDeployInput: SimulateDeployInput
14967
+ """Input for a token contract create transaction simulation."""
14968
+ simulateCreateTransactionInput: SimulateCreateTransactionInput
14969
+ """Input for a live token contract simulation."""
14970
+ simulateLiveContractInput: SimulateLiveContractInput
14971
+ }
14972
+
14191
14973
  """Response returned by `getLatestTokens`."""
14192
14974
  type LatestTokenConnection {
14193
14975
  """A list of newly created tokens."""
@@ -14471,9 +15253,9 @@ input OnLaunchpadTokenEventInput {
14471
15253
  protocol: LaunchpadTokenProtocol
14472
15254
  """A list of launchpad protocols."""
14473
15255
  protocols: [LaunchpadTokenProtocol!]
14474
- """The name of the launchpad. One of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, pons, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, UniswapCCA, tren.ch, StonkFun."""
15256
+ """The name of the launchpad. One of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel."""
14475
15257
  launchpadName: String
14476
- """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, pons, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, UniswapCCA, tren.ch, StonkFun."""
15258
+ """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel."""
14477
15259
  launchpadNames: [String!]
14478
15260
  """The type of event."""
14479
15261
  eventType: LaunchpadTokenEventType
@@ -14692,9 +15474,9 @@ input OnLaunchpadTokenEventBatchInput {
14692
15474
  protocols: [LaunchpadTokenProtocol!]
14693
15475
  """The network ID that the token is deployed on."""
14694
15476
  networkId: Int
14695
- """The name of the launchpad. One of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, pons, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, UniswapCCA, tren.ch, StonkFun."""
15477
+ """The name of the launchpad. One of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel."""
14696
15478
  launchpadName: String
14697
- """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, pons, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, UniswapCCA, tren.ch, StonkFun."""
15479
+ """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel."""
14698
15480
  launchpadNames: [String!]
14699
15481
  """The type of event."""
14700
15482
  eventType: LaunchpadTokenEventType
@@ -14714,20 +15496,54 @@ input OnUnconfirmedEventsCreatedByMakerInput {
14714
15496
 
14715
15497
  """Wallet labels. Used for filtering wallets with `includeLabels` and `excludeLabels`."""
14716
15498
  enum WalletLabel {
15499
+ """On our internal blacklist."""
15500
+ BLACKLISTED
15501
+ """Automated trading bot: proven by arbitrage inside its own transactions, or inferred from its trading cadence. Its confidence is `botScore`."""
15502
+ BOT
15503
+ """Cross-chain bridge contract."""
15504
+ BRIDGE
15505
+ """Centralized exchange wallet."""
15506
+ CEX
15507
+ """Decentralized exchange wallet."""
15508
+ DEX
15509
+ """Project founder wallet."""
15510
+ FOUNDER
15511
+ """Exploited a contract."""
15512
+ HACKER
15513
+ """Pre-launch insider buyer."""
15514
+ INSIDER
14717
15515
  """Wallet is interesting (based on a number of factors)."""
14718
15516
  INTERESTING
15517
+ """Key opinion leader / influencer."""
15518
+ KOL
14719
15519
  """Wallet holds $5M+ in assets."""
14720
15520
  MEDIUM_WEALTHY
14721
15521
  """Wallet holds $10M+ in assets."""
14722
15522
  MEGA_WEALTHY
15523
+ """MEV extraction bot."""
15524
+ MEV_BOT
15525
+ """Privacy mixer."""
15526
+ MIXER
15527
+ """Known rug-puller."""
15528
+ RUG_PULLER
15529
+ """OFAC sanctioned."""
15530
+ SANCTIONED
15531
+ """Wallet behind token scams: a serial rug deployer, its launch crew, or a honeypot creator. Its confidence is `scammerScore`."""
15532
+ SCAMMER
14723
15533
  """Wallet has made over $7.5K profit in the last 90 days trading tokens that are older than 2 days."""
14724
15534
  SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD
14725
15535
  """Wallet has made over $5K profit in the last 90 days trading tokens that are between 1 hour and 2 days old."""
14726
15536
  SMART_TRADER_TOKENS_UNDER_TWO_DAYS_OLD
14727
15537
  """Wallet has made over $3K profit in the last 90 days trading tokens that were launched within their first hour."""
14728
15538
  SNIPER
15539
+ """Venture capital fund."""
15540
+ VC
15541
+ """Operator-run wallet that trades to manufacture a token's volume: one a volume-bot platform runs, or one of hundreds a single funder seeded to churn one pool."""
15542
+ VOLUME_BOT
14729
15543
  """Wallet holds $1M+ in assets."""
14730
15544
  WEALTHY
15545
+ """High-balance / high-volume wallet."""
15546
+ WHALE
14731
15547
  }
14732
15548
 
14733
15549
  """Response returned by `onHoldersUpdated`."""
@@ -14754,6 +15570,62 @@ type LiquidityLockConnection {
14754
15570
  pairLiquidityData: [PairLiquidityData!]!
14755
15571
  }
14756
15572
 
15573
+ """Response returned by `liquidityLocksV2`."""
15574
+ type LiquidityLockV2Connection {
15575
+ """Lock state per pair."""
15576
+ items: [PairLockSummary!]!
15577
+ """A cursor for use in pagination."""
15578
+ cursor: String
15579
+ }
15580
+
15581
+ """Current lock state of one pair."""
15582
+ type PairLockSummary {
15583
+ """The pair address."""
15584
+ pairAddress: String!
15585
+ """The network ID the pair is deployed on."""
15586
+ networkId: Int!
15587
+ """The protocol that created the pair."""
15588
+ liquidityProtocol: String!
15589
+ """Total pool liquidity, raw units — the denominator."""
15590
+ liquidity: String!
15591
+ """Liquidity currently locked, with vesting matured to now."""
15592
+ locked: String!
15593
+ """Locked share of the pool, 0-100. Null when the pool carries no usable signal."""
15594
+ lockedPercent: Float
15595
+ """Liquidity locked permanently (burned or locked forever)."""
15596
+ permanentLocked: String!
15597
+ """Liquidity locked behind a vesting schedule."""
15598
+ vestedLocked: String!
15599
+ """Liquidity not locked."""
15600
+ unlocked: String!
15601
+ """Who holds the locked liquidity."""
15602
+ holders: [PairLockHolder!]!
15603
+ """Next point at which vested liquidity matures, in the pool's own clock units."""
15604
+ nextReleasePoint: String
15605
+ """The unix timestamp of the state read this was served from."""
15606
+ updatedAt: Int!
15607
+ """False when vesting could not be matured to now and the figures are as of the last refresh."""
15608
+ current: Boolean!
15609
+ }
15610
+
15611
+ """One holder's share of a pair's locked liquidity."""
15612
+ type PairLockHolder {
15613
+ """Attribution registry entity id, e.g. `uncx` or `burn:0x...`. Null when the position holds itself."""
15614
+ entityId: String
15615
+ """Registry display name, when known."""
15616
+ displayName: String
15617
+ """The locking protocol, where the entity maps onto the enum. Null for lockers the enum cannot name."""
15618
+ lockProtocol: LiquidityLockProtocol
15619
+ """The amount of liquidity locked, raw units."""
15620
+ amount: String!
15621
+ """True when the lock can never be withdrawn."""
15622
+ permanent: Boolean!
15623
+ """The unix timestamp for when the lock expires, in seconds as a string — lock dates can exceed the 32-bit range. Null for permanent locks."""
15624
+ unlockAt: String
15625
+ """True when several holders name the same liquidity; count it once."""
15626
+ shared: Boolean
15627
+ }
15628
+
14757
15629
  """Liquidity data for a specific pair."""
14758
15630
  type PairLiquidityData {
14759
15631
  """The ID of the pair (`address:networkId`)."""
@@ -14806,7 +15678,25 @@ enum LiquidityLockProtocol {
14806
15678
  METEORA_DAMM_V2
14807
15679
  DOPPLER
14808
15680
  O1_EXCHANGE
15681
+ MINARA
14809
15682
  PONS_V2
15683
+ METAPLEX_GENESIS
15684
+ PINKSALE
15685
+ TEAM_FINANCE
15686
+ LAUNCH_FAIR
15687
+ BAGS
15688
+ RAYDIUM_LOCK
15689
+ LETSCASH
15690
+ PAIR
15691
+ LAUNCH_HOOK
15692
+ LUNCH_FUN
15693
+ LAUNCH_TAX_HOOK
15694
+ PEACH
15695
+ FOCI
15696
+ LIFT
15697
+ LONG_SUPPLY
15698
+ TOLLY
15699
+ FLYWHEEL
14810
15700
  }
14811
15701
 
14812
15702
  """Protocols that create trading pairs."""
@@ -15745,8 +16635,10 @@ type NetworkWalletFilterResult {
15745
16635
  nativeTokenBalance: String!
15746
16636
  """The labels associated with the wallet"""
15747
16637
  labels: [String!]!
15748
- """Manual or proposal-derived identity vocabulary (e.g. WHALE, KOL). Distinct from behavioral `labels`."""
16638
+ """Labels on the wallet's profile: identity (e.g. WHALE, KOL) and the behaviour our labelling jobs write (BOT, SCAMMER, VOLUME_BOT). See [`WalletLabel`](/api-reference/enums/walletlabel)."""
15749
16639
  identityLabels: [String!]
16640
+ """Registry entity ids of the apps this wallet trades through — e.g. `defined` for defined.fi, or `axiom`. Means "trades through", never "is owned by": one routed trade is enough to appear here."""
16641
+ tradeSourceIds: [String!]
15750
16642
  """Volume in USD in the past day"""
15751
16643
  volumeUsd1d: String!
15752
16644
  """Total volume in USD in the past day including all tokens"""
@@ -15891,6 +16783,8 @@ type TokenWalletFilterResult {
15891
16783
  lastTransactionAt: Int!
15892
16784
  """The labels associated with the wallet"""
15893
16785
  labels: [String!]!
16786
+ """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"."""
16787
+ walletTradeSourceIds: [String!]
15894
16788
  """Token amount bought in the past day"""
15895
16789
  tokenAmountBought1d: String!
15896
16790
  """Token amount sold in the past day"""
@@ -16031,7 +16925,7 @@ input TokenTopTradersInput {
16031
16925
  networkId: Int!
16032
16926
  """The trading period"""
16033
16927
  tradingPeriod: TradingPeriod!
16034
- """How to rank the results. Defaults to `realizedProfitUsd` descending. Note: when ranking by `realizedProfitUsd`, only wallets with positive realized profit are returned."""
16928
+ """How to rank the results. Defaults to `realizedProfitUsd` descending. Note: when ranking by `realizedProfitUsd`, descending returns only wallets with positive realized profit, and ascending returns only wallets with negative realized profit (the biggest losers first)."""
16035
16929
  ranking: TokenTopTradersRanking
16036
16930
  """The number of traders to return"""
16037
16931
  limit: Int
@@ -16051,6 +16945,10 @@ input FilterWalletsInput {
16051
16945
  excludeLabels: [String]
16052
16946
  """Include wallets with these labels. See [`WalletLabel`](/api-reference/enums/walletlabel) for possible values."""
16053
16947
  includeLabels: [String]
16948
+ """Include only wallets that have traded through any of these apps, by registry entity id — e.g. `defined` for defined.fi, or `axiom`."""
16949
+ includeTradeSourceIds: [String]
16950
+ """Exclude wallets that have traded through any of these apps, by registry entity id."""
16951
+ excludeTradeSourceIds: [String]
16054
16952
  """A list of ranking attributes to apply."""
16055
16953
  rankings: [WalletRanking]
16056
16954
  """The maximum number of wallets to return."""
@@ -16103,6 +17001,10 @@ input FilterTokenWalletsInput {
16103
17001
  excludeLabels: [String]
16104
17002
  """Include wallets with these labels. See [`WalletLabel`](/api-reference/enums/walletlabel) for possible values."""
16105
17003
  includeLabels: [String]
17004
+ """Include only wallets that have traded through any of these apps, by registry entity id — e.g. `defined` for defined.fi, or `axiom`. Matches the wallet's apps overall, not the apps it used for this token."""
17005
+ includeTradeSourceIds: [String]
17006
+ """Exclude wallets that have traded through any of these apps, by registry entity id."""
17007
+ excludeTradeSourceIds: [String]
16106
17008
  """The maximum number of wallets to return"""
16107
17009
  limit: Int
16108
17010
  """Where in the list the server should start when returning items"""
@@ -16361,6 +17263,8 @@ enum WalletCategory {
16361
17263
  POOL_AUTHORITY
16362
17264
  STAKING_VAULT
16363
17265
  NOTORIOUS
17266
+ BURN
17267
+ LOCKER
16364
17268
  }
16365
17269
 
16366
17270
  """The response for the `walletAggregateBackfillState` mutation."""
@@ -16374,12 +17278,70 @@ input WalletAggregateBackfillStateInput {
16374
17278
  walletAddress: String!
16375
17279
  }
16376
17280
 
17281
+ """Input for `tokenWalletStats`."""
17282
+ input TokenWalletStatsInput {
17283
+ """The contract address of the token."""
17284
+ tokenAddress: String!
17285
+ """The network ID the token is deployed on."""
17286
+ networkId: Int!
17287
+ }
17288
+
17289
+ """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."""
17290
+ type TokenWalletStats {
17291
+ """The ID of the token (`address:networkId`)."""
17292
+ tokenId: String!
17293
+ """The contract address of the token."""
17294
+ tokenAddress: String!
17295
+ """The network ID the token is deployed on."""
17296
+ networkId: Int!
17297
+ """The total supply of the token, unshifted. Every held percentage is measured against it."""
17298
+ tokenTotalSupply: String!
17299
+ """The number of sniper wallets that hold this token. A sniper bought within the first 5 seconds of trading."""
17300
+ sniperCount: Int!
17301
+ """The percentage of token supply held by sniper wallets."""
17302
+ sniperHeldPercentage: Float!
17303
+ """The sniper wallets that hold this token. Limited to 200."""
17304
+ sniperAddresses: [String!]!
17305
+ """The amount of the token held by sniper wallets, unshifted."""
17306
+ sniperHeldAmount: String!
17307
+ """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."""
17308
+ bundlerCount: Int!
17309
+ """The percentage of token supply held by bundler wallets."""
17310
+ bundlerHeldPercentage: Float!
17311
+ """The bundler wallets that hold this token. Limited to 200."""
17312
+ bundlerAddresses: [String!]!
17313
+ """The amount of the token held by bundler wallets, unshifted."""
17314
+ bundlerHeldAmount: String!
17315
+ """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."""
17316
+ insiderCount: Int!
17317
+ """The percentage of token supply held by insider wallets."""
17318
+ insiderHeldPercentage: Float!
17319
+ """The insider wallets that hold this token. Limited to 200."""
17320
+ insiderAddresses: [String!]!
17321
+ """The amount of the token held by insider wallets, unshifted."""
17322
+ insiderHeldAmount: String!
17323
+ """The number of suspicious wallets — the deduplicated union of snipers, bundlers, and insiders — that hold this token."""
17324
+ suspiciousCount: Int!
17325
+ """The percentage of token supply held by suspicious wallets (deduplicated union of snipers, bundlers, and insiders)."""
17326
+ suspiciousHeldPercentage: Float!
17327
+ """The suspicious wallets that hold this token. Limited to 200."""
17328
+ suspiciousAddresses: [String!]!
17329
+ """The amount of the token held by suspicious wallets, unshifted."""
17330
+ suspiciousHeldAmount: String!
17331
+ """The percentage of token supply held by the developer/creator wallet."""
17332
+ devHeldPercentage: Float!
17333
+ """The developer/creator wallet. Empty when the creator is unknown."""
17334
+ devAddress: String!
17335
+ """The amount of the token held by the developer/creator wallet, unshifted."""
17336
+ devHeldAmount: String!
17337
+ }
17338
+
16377
17339
  type Wallet {
16378
17340
  address: String!
16379
17341
  category: WalletCategory
16380
17342
  firstSeenTimestamp: Int
16381
17343
  firstFunding: WalletFunding
16382
- """Identity labels describing what this wallet is (e.g. CEX, DEX, bridge, team)"""
17344
+ """Labels on the wallet's profile: identity (e.g. CEX, DEX, KOL) and the behaviour our labelling jobs write (BOT, SCAMMER, VOLUME_BOT). See [`WalletLabel`](/api-reference/enums/walletlabel)."""
16383
17345
  identityLabels: [String!]
16384
17346
  """Resolved profile avatar URL (best available source)"""
16385
17347
  avatarUrl: String
@@ -16415,6 +17377,8 @@ type Wallet {
16415
17377
  ethosLevel: String
16416
17378
  """Ethos Network verification status"""
16417
17379
  ethosVerified: Boolean
17380
+ """Registry entity ids of the apps this wallet trades through — e.g. `defined` for defined.fi, or `axiom`. Means "trades through", never "is owned by": one routed trade is enough to appear here."""
17381
+ tradeSourceIds: [String!]
16418
17382
  """Source of identity data (e.g. ethos, manual, polymarket-backfill)"""
16419
17383
  identitySource: String
16420
17384
  """When identity data was last updated (unix timestamp)"""
@@ -16589,6 +17553,8 @@ type EvmNetworkConfig {
16589
17553
  networkType: NetworkConfigType!
16590
17554
  stableCoinAddresses: [String!]
16591
17555
  wrappedBaseTokenSymbol: String!
17556
+ """The network's native currency descriptor, when it has one. Native balances scale by its decimals; token metadata keeps the ERC-20 decimals."""
17557
+ nativeCurrency: NativeCurrency
16592
17558
  }
16593
17559
 
16594
17560
  type SolanaNetworkConfig {
@@ -16739,5 +17705,7 @@ type Event {
16739
17705
  walletLabels: [String!]
16740
17706
  """The app the trade was placed through, when it could be determined. Null for the majority of events — most on-chain trades carry no identifying signal. Currently populated for Solana swaps only."""
16741
17707
  tradeSource: TradeSource
17708
+ """The measurement units of the raw side amounts in `data` (`amount0`, `amount1`, …); null when the pool measures in its tokens' metadata."""
17709
+ currencyUnits: CurrencyUnits
16742
17710
  }
16743
17711