@codex-data/sdk 2.5.14 → 2.5.18

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,6 @@ 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!
297
291
  """Returns windowed and all-time stats for a prediction market."""
298
292
  detailedPredictionMarketStats(
299
293
  """Input parameters used to select a market and stat windows."""
@@ -508,6 +502,12 @@ type Query {
508
502
  getNetworkConfigs(
509
503
  networkIds: [Int!]
510
504
  ): [NetworkConfig!]!
505
+ """Returns the full vocabulary of wallet label types and their metadata."""
506
+ walletLabelTypes: [WalletLabelType!]!
507
+ """Returns community gathered notes."""
508
+ getCommunityNotes(
509
+ input: CommunityNotesInput
510
+ ): CommunityNotesResponse!
511
511
  """Discover, screen, and rank tokens across every supported network using 100+ on-chain signals: trading activity, liquidity, holder behavior, fee economics, and launchpad lifecycle."""
512
512
  filterTokens(
513
513
  """A set of filters to apply."""
@@ -3998,6 +3998,7 @@ type SocialLinks {
3998
3998
  wechat: String
3999
3999
  whitepaper: String
4000
4000
  youtube: String
4001
+ tiktok: String
4001
4002
  }
4002
4003
 
4003
4004
  """Game data for a Parallel asset."""
@@ -4734,817 +4735,142 @@ type AddNftPoolEventsOutput {
4734
4735
 
4735
4736
  scalar JSON
4736
4737
 
4737
- scalar Void
4738
-
4739
- """Type of the community gathered note."""
4740
- enum CommunityNoteType {
4741
- """An contract attribute change."""
4742
- ATTRIBUTE
4743
- """A scam report."""
4744
- SCAM
4745
- """A logo change."""
4746
- LOGO
4738
+ """A prediction sub-subcategory (3rd level, terminal)."""
4739
+ type PredictionSubSubcategory {
4740
+ """The display name."""
4741
+ name: String!
4742
+ """The URL slug."""
4743
+ slug: String!
4747
4744
  }
4748
4745
 
4749
- """Type of the contract."""
4750
- enum ContractType {
4751
- TOKEN
4752
- WALLET
4746
+ """A prediction subcategory (2nd level)."""
4747
+ type PredictionSubcategory {
4748
+ """The display name."""
4749
+ name: String!
4750
+ """The URL slug."""
4751
+ slug: String!
4752
+ """Nested subcategories (3rd level)."""
4753
+ subcategories: [PredictionSubSubcategory!]
4753
4754
  }
4754
4755
 
4755
- enum ContractProposalStatus {
4756
- ACCEPTED
4757
- PENDING
4758
- REJECTED
4759
- REVERTED
4756
+ """A prediction category with optional nested subcategories."""
4757
+ type PredictionCategory {
4758
+ """The display name."""
4759
+ name: String!
4760
+ """The URL slug."""
4761
+ slug: String!
4762
+ """Nested subcategories (2nd level)."""
4763
+ subcategories: [PredictionSubcategory!]
4760
4764
  }
4761
4765
 
4762
- """The attribute used to rank tokens."""
4763
- enum TokenRankingAttribute {
4764
- """Weighted risk score."""
4765
- riskScore
4766
- """Unix seconds of the token's latest recorded risk change."""
4767
- riskFlaggedAt
4768
- createdAt
4769
- tokenCreatedAt
4770
- lastTransaction
4771
- age @deprecated(reason: "Use createdAt instead")
4772
- buyCount5m
4773
- buyCount1
4774
- buyCount4
4775
- buyCount12
4776
- buyCount24
4777
- change5m
4778
- change1
4779
- change4
4780
- change12
4781
- change24
4782
- volumeChange5m
4783
- volumeChange1
4784
- volumeChange4
4785
- volumeChange12
4786
- volumeChange24
4787
- high5m
4788
- high1
4789
- high4
4790
- high12
4791
- high24
4792
- holders
4793
- notableHolderCount
4794
- liquidity
4795
- totalLiquidityUsd
4796
- low5m
4797
- low1
4798
- low4
4799
- low12
4800
- low24
4801
- marketCap
4802
- circulatingMarketCap
4803
- priceUSD
4804
- sellCount5m
4805
- sellCount1
4806
- sellCount4
4807
- sellCount12
4808
- sellCount24
4809
- trendingScore
4810
- trendingScore5m
4811
- trendingScore1
4812
- trendingScore4
4813
- trendingScore12
4814
- trendingScore24
4815
- txnCount5m
4816
- txnCount1
4817
- txnCount4
4818
- txnCount12
4819
- txnCount24
4820
- uniqueBuys5m
4821
- uniqueBuys1
4822
- uniqueBuys4
4823
- uniqueBuys12
4824
- uniqueBuys24
4825
- uniqueSells5m
4826
- uniqueSells1
4827
- uniqueSells4
4828
- uniqueSells12
4829
- uniqueSells24
4830
- uniqueTransactions5m
4831
- uniqueTransactions1
4832
- uniqueTransactions4
4833
- uniqueTransactions12
4834
- uniqueTransactions24
4835
- volume5m
4836
- volume1
4837
- volume4
4838
- volume12
4839
- volume24
4840
- buyVolume5m
4841
- buyVolume1
4842
- buyVolume4
4843
- buyVolume12
4844
- buyVolume24
4845
- sellVolume5m
4846
- sellVolume1
4847
- sellVolume4
4848
- sellVolume12
4849
- sellVolume24
4850
- poolFees5m
4851
- poolFees1
4852
- poolFees4
4853
- poolFees12
4854
- poolFees24
4855
- baseFees5m
4856
- baseFees1
4857
- baseFees4
4858
- baseFees12
4859
- baseFees24
4860
- priorityFees5m
4861
- priorityFees1
4862
- priorityFees4
4863
- priorityFees12
4864
- priorityFees24
4865
- builderTips5m
4866
- builderTips1
4867
- builderTips4
4868
- builderTips12
4869
- builderTips24
4870
- l1DataFees5m
4871
- l1DataFees1
4872
- l1DataFees4
4873
- l1DataFees12
4874
- l1DataFees24
4875
- totalFees5m
4876
- totalFees1
4877
- totalFees4
4878
- totalFees12
4879
- totalFees24
4880
- feeToVolumeRatio5m
4881
- feeToVolumeRatio1
4882
- feeToVolumeRatio4
4883
- feeToVolumeRatio12
4884
- feeToVolumeRatio24
4885
- launchpadCompletedAt
4886
- launchpadMigratedAt
4887
- graduationPercent
4888
- walletAgeAvg
4889
- walletAgeStd
4890
- swapPct1dOldWallet
4891
- swapPct7dOldWallet
4892
- sniperHeldPercentage
4893
- bundlerHeldPercentage
4894
- insiderHeldPercentage
4895
- suspiciousHeldPercentage
4896
- sniperCount
4897
- bundlerCount
4898
- insiderCount
4899
- suspiciousCount
4900
- devHeldPercentage
4901
- top10HoldersPercent
4902
- coinCommunityPostCount
4903
- coinCommunityMemberCount
4904
- coinCommunityLikeCount
4905
- coinCommunityLastPostAt
4766
+ """The duration used to request windowed prediction stats."""
4767
+ enum PredictionStatsDuration {
4768
+ week1
4769
+ day1
4770
+ hour12
4771
+ hour4
4772
+ hour1
4773
+ min5
4906
4774
  }
4907
4775
 
4908
- """Input type of `TokenRanking`."""
4909
- input TokenRanking {
4910
- """The attribute to rank tokens by."""
4911
- attribute: TokenRankingAttribute
4912
- """The direction to apply to the ranking attribute."""
4913
- direction: RankingDirection
4776
+ """Input type of `detailedPredictionMarketStats`."""
4777
+ input DetailedPredictionMarketStatsInput {
4778
+ """The ID of the prediction market."""
4779
+ marketId: String!
4780
+ """The unix timestamp."""
4781
+ timestamp: Int
4782
+ """The stat durations to include."""
4783
+ durations: [PredictionStatsDuration!]
4784
+ """The number of stat buckets to return."""
4785
+ bucketCount: Int
4914
4786
  }
4915
4787
 
4916
- """Real-time or historical prices for a token."""
4917
- type Price {
4918
- """The contract address of the token."""
4919
- address: String!
4920
- """The unix timestamp for the price."""
4921
- timestamp: Int
4922
- """The network ID the token is deployed on."""
4923
- networkId: Int!
4924
- """The token price in USD."""
4925
- priceUsd: Float!
4926
- """The pool that emitted the swap generating this price"""
4927
- blockNumber: Int
4928
- """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. On subscriptions it is the `totalLiquidityUsd` value only, refreshed at most every 30 seconds, and null on networks where the real-money total is not enabled."""
4929
- liquidityUsd: String
4930
- """The percent price change in the past 24 hours. Decimal format. Not available via subscription."""
4931
- priceChange24: Float
4932
- """The pool that emitted the swap generating this price"""
4933
- poolAddress: String @deprecated(reason: "Pricing no longer based on specific pools")
4934
- """Ratio of how confident we are in the price"""
4935
- confidence: Float @deprecated(reason: "Pricing no longer based on specific pools")
4788
+ """A currency value pair containing both USD and collateral token values."""
4789
+ type CurrencyValuePair {
4790
+ """Value in USD."""
4791
+ usd: String!
4792
+ """Value in collateral token units."""
4793
+ ct: String!
4936
4794
  }
4937
4795
 
4938
- """Metadata for a token."""
4939
- type EnhancedToken {
4940
- """The ID of the token (`address:networkId`)."""
4941
- id: String!
4942
- """The contract address of the token."""
4943
- address: String!
4944
- """The token ID on CoinMarketCap."""
4945
- cmcId: Int
4946
- """The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals)."""
4947
- decimals: Int!
4948
- """Whether the token has been flagged as a scam."""
4949
- isScam: Boolean
4950
- """The token name. For example, `ApeCoin`."""
4951
- name: String
4952
- """The network ID the token is deployed on."""
4953
- networkId: Int!
4954
- """The token symbol. For example, `APE`."""
4955
- symbol: String
4956
- """The total supply of the token."""
4957
- totalSupply: String @deprecated(reason: "Use the TokenInfo type")
4958
- """Community gathered links for the socials of this token."""
4959
- socialLinks: SocialLinks
4960
- """More metadata about the token."""
4961
- info: TokenInfo
4962
- """The Grid asset ID, if this token is linked to a Grid asset."""
4963
- gridAssetId: String
4964
- """The Grid bluechip rating for this token (e.g. `A+`, `B-`)."""
4965
- bluechipRating: String
4966
- """The Grid organization associated with this token. Null when the token is reached through `AssetDeployment.token`."""
4967
- organization: Organization
4968
- """The Grid asset associated with this token. Null when the token is reached through `AssetDeployment.token`."""
4969
- asset: Asset
4970
- """Information about the token from 3rd party sources."""
4971
- explorerData: ExplorerTokenData @deprecated(reason: "Use the TokenInfo type")
4972
- """A list of exchanges where the token has been traded."""
4973
- exchanges: [Exchange!]
4974
- """The thumbnail token logo URL."""
4975
- imageThumbUrl: String @deprecated(reason: "Use the TokenInfo type")
4976
- """The small token logo URL."""
4977
- imageSmallUrl: String @deprecated(reason: "Use the TokenInfo type")
4978
- """The large token logo URL."""
4979
- imageLargeUrl: String @deprecated(reason: "Use the TokenInfo type")
4980
- """The circulating supply of the token."""
4981
- circulatingSupply: String @deprecated(reason: "Use the TokenInfo type")
4982
- """The amount of this token in the pair."""
4983
- pooled: String @deprecated(reason: "Pooled can be found on the pair instead")
4984
- """The token creator's wallet address."""
4985
- creatorAddress: String
4986
- """The token creator's wallet identity and profile, resolved from creatorAddress. Null when the token has no known creator."""
4987
- creator: Wallet
4988
- """The token creator's network-based token balance at time of contract creation."""
4989
- creatorBalanceNBT: String
4990
- """The block height the token was created at."""
4991
- createBlockNumber: Int
4992
- """The transaction hash of the token's creation."""
4993
- createTransactionHash: String
4994
- """The unix timestamp for the creation of the token."""
4995
- createdAt: Int
4996
- """Returns mint authority address if token is mintable. If null, verify against isMintableValid."""
4997
- mintable: String
4998
- """Returns freeze authority address if token is freezable. If null, verify against isFreezableValid."""
4999
- freezable: String
5000
- """Determines if freezable is a valid address or null value for the authority, or if the freezable state has not yet been determined."""
5001
- isFreezableValid: Boolean
5002
- """Determines if mintable is a valid address or null value for the authority, or if the mintable state has not yet been determined."""
5003
- isMintableValid: Boolean
5004
- """The launchpad data for the token, if applicable."""
5005
- launchpad: LaunchpadData
5006
- """The percentage of total supply held by the top 10 holders (excluding exchanges/pairs)."""
5007
- top10HoldersPercent: Float
5008
- """Whether the token name or symbol contains profanity."""
5009
- profanity: Boolean
5010
- """All-time high and low price/market cap data for the token."""
5011
- extrema: TokenExtrema
5012
- """The Coin Community data for the token"""
5013
- coinCommunity: CoinCommunity
5014
- """Token extension metadata, if available."""
5015
- extensions: TokenExtensions
5016
- """Token-standard-specific custom metadata — currently ERC-7572 `contractURI` fields, as used by Base B20 tokens. Null for tokens without a recognized token standard."""
5017
- tokenStandardCustomData: Erc7572CustomInfo
5018
- categories: [Category!]
5019
- """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`."""
5020
- risk: TokenRisk
5021
- """The issuer of a real-world-asset token, such as a tokenized stock. Null when the token has no known issuer."""
5022
- issuer: TokenIssuer
4796
+ """OHLC (Open/High/Low/Close) values for a currency pair."""
4797
+ type CurrencyOHLC {
4798
+ """Opening value."""
4799
+ open: CurrencyValuePair!
4800
+ """Closing value."""
4801
+ close: CurrencyValuePair!
4802
+ """Low value."""
4803
+ low: CurrencyValuePair!
4804
+ """High value."""
4805
+ high: CurrencyValuePair!
5023
4806
  }
5024
4807
 
5025
- """A token matching a set of filter parameters."""
5026
- type TokenFilterResult {
5027
- """Metadata for the token."""
5028
- token: EnhancedToken
5029
- """The unix timestamp for the creation of the token's first pair."""
5030
- createdAt: Int
5031
- """The unix timestamp for the token's last transaction."""
5032
- lastTransaction: Int
5033
- age: Int @deprecated(reason: "Age isn't supported - use createdAt instead")
5034
- """The number of buys in the past 5 minutes."""
5035
- buyCount5m: Int
5036
- """The number of buys in the past hour."""
5037
- buyCount1: Int
5038
- """The number of buys in the past 12 hours."""
5039
- buyCount12: Int
5040
- """The number of buys in the past 24 hours."""
5041
- buyCount24: Int
5042
- """The number of buys in the past 4 hours."""
5043
- buyCount4: Int
5044
- """The percent price change in the past 5 minutes. Decimal format."""
5045
- change5m: String
5046
- """The percent price change in the past hour. Decimal format."""
5047
- change1: String
5048
- """The percent price change in the past 12 hours. Decimal format."""
5049
- change12: String
5050
- """The percent price change in the past 24 hours. Decimal format."""
5051
- change24: String
5052
- """The percent price change in the past 4 hours. Decimal format."""
5053
- change4: String
5054
- """The percent volume change in the past 5 minutes. Decimal format."""
5055
- volumeChange5m: String
5056
- """The percent volume change in the past hour. Decimal format."""
5057
- volumeChange1: String
5058
- """The percent volume change in the past 4 hours. Decimal format."""
5059
- volumeChange4: String
5060
- """The percent volume change in the past 12 hours. Decimal format."""
5061
- volumeChange12: String
5062
- """The percent volume change in the past 24 hours. Decimal format."""
5063
- volumeChange24: String
5064
- """The exchanges the token is listed on."""
5065
- exchanges: [Exchange]
5066
- fdv: String @deprecated(reason: "FDV isn't supported - use marketCap instead")
5067
- """The highest price in USD in the past 5 minutes."""
5068
- high5m: String
5069
- """The highest price in USD in the past hour."""
5070
- high1: String
5071
- """The highest price in USD in the past 12 hours."""
5072
- high12: String
5073
- """The highest price in USD in the past 24 hours."""
5074
- high24: String
5075
- """The highest price in USD in the past 4 hours."""
5076
- high4: String
5077
- """The token's liquidity in USD. On networks where the real-money total is enabled, this is the same value as `totalLiquidityUsd` (the combined liquidity of its 15 deepest pools) once the token has one. On other networks it is the liquidity of the token's top pair, or with `useAggregatedStats` 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."""
5078
- liquidity: String
5079
- """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. On networks where the real-money total is enabled, `liquidity` is the same value; elsewhere `liquidity` covers the top pair only (or the aggregated liquidity with `useAggregatedStats`). 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."""
5080
- totalLiquidityUsd: String
5081
- """The token of interest. Can be `token0` or `token1`."""
5082
- quoteToken: String
5083
- """The lowest price in USD in the past 5 minutes."""
5084
- low5m: String
5085
- """The lowest price in USD in the past hour."""
5086
- low1: String
5087
- """The lowest price in USD in the past 12 hours."""
5088
- low12: String
5089
- """The lowest price in USD in the past 24 hours."""
5090
- low24: String
5091
- """The lowest price in USD in the past 4 hours."""
5092
- low4: String
5093
- """The fully diluted market cap."""
5094
- marketCap: String
5095
- """The circulating market cap."""
5096
- circulatingMarketCap: String
5097
- """Metadata for the token's top pair."""
5098
- pair: Pair
5099
- """Metadata for the token's most liquid pair"""
5100
- liquidPair: Pair
5101
- """The liquidity of the token's most liquid pair. On networks where the real-money total is enabled, this is the same value as `totalLiquidityUsd` (the combined liquidity of the token's 15 deepest pools) once the token has one. The value is recomputed when the token trades."""
5102
- liquidPairLiquidity: String
5103
- """The liquid pairs price in USD."""
5104
- liquidPairPriceUSD: String
5105
- """The token price in USD."""
5106
- priceUSD: String
5107
- """A heuristic based on various factors used to rank tokens based on how trending they are."""
5108
- trendingScore: Float
5109
- """The number of sells in the past 5 minutes."""
5110
- sellCount5m: Int
5111
- """The number of sells in the past hour."""
5112
- sellCount1: Int
5113
- """The number of sells in the past 12 hours."""
5114
- sellCount12: Int
5115
- """The number of sells in the past 24 hours."""
5116
- sellCount24: Int
5117
- """The number of sells in the past 4 hours."""
5118
- sellCount4: Int
5119
- """The number of transactions in the past 5 minutes."""
5120
- txnCount5m: Int
5121
- """The number of transactions in the past hour."""
5122
- txnCount1: Int
5123
- """The number of transactions in the past 12 hours."""
5124
- txnCount12: Int
5125
- """The number of transactions in the past 24 hours."""
5126
- txnCount24: Int
5127
- """The number of transactions in the past 4 hours."""
5128
- txnCount4: Int
5129
- """The unique number of buys in the past 5 minutes."""
5130
- uniqueBuys5m: Int
5131
- """The unique number of buys in the past hour."""
5132
- uniqueBuys1: Int
5133
- """The unique number of buys in the past 12 hours."""
5134
- uniqueBuys12: Int
5135
- """The unique number of buys in the past 24 hours."""
5136
- uniqueBuys24: Int
5137
- """The unique number of buys in the past 4 hours."""
5138
- uniqueBuys4: Int
5139
- """The unique number of sells in the past 5 minutes."""
5140
- uniqueSells5m: Int
5141
- """The unique number of sells in the past hour."""
5142
- uniqueSells1: Int
5143
- """The unique number of sells in the past 12 hours."""
5144
- uniqueSells12: Int
5145
- """The unique number of sells in the past 24 hours."""
5146
- uniqueSells24: Int
5147
- """The unique number of sells in the past 4 hours."""
5148
- uniqueSells4: Int
5149
- """The unique number of transactions in the past 5 minutes."""
5150
- uniqueTransactions5m: Int
5151
- """The unique number of transactions in the past hour."""
5152
- uniqueTransactions1: Int
5153
- """The unique number of transactions in the past 12 hours."""
5154
- uniqueTransactions12: Int
5155
- """The unique number of transactions in the past 24 hours."""
5156
- uniqueTransactions24: Int
5157
- """The unique number of transactions in the past 4 hours."""
5158
- uniqueTransactions4: Int
5159
- """The trade volume in USD in the past hour."""
5160
- volume1: String
5161
- """The trade volume in USD in the past 5 minutes."""
5162
- volume5m: String
5163
- """The trade volume in USD in the past 12 hours."""
5164
- volume12: String
5165
- """The trade volume in USD in the past 24 hours."""
5166
- volume24: String
5167
- """The trade volume in USD in the past 4 hours."""
5168
- volume4: String
5169
- """The buy volume in USD in the past hour."""
5170
- buyVolume1: String
5171
- """The buy volume in USD in the past 12 hours."""
5172
- buyVolume12: String
5173
- """The buy volume in USD in the past 24 hours."""
5174
- buyVolume24: String
5175
- """The buy volume in USD in the past 4 hours."""
5176
- buyVolume4: String
5177
- """The buy volume in USD in the past 5 minutes."""
5178
- buyVolume5m: String
5179
- """The sell volume in USD in the past hour."""
5180
- sellVolume1: String
5181
- """The sell volume in USD in the past 12 hours."""
5182
- sellVolume12: String
5183
- """The sell volume in USD in the past 24 hours."""
5184
- sellVolume24: String
5185
- """The sell volume in USD in the past 4 hours."""
5186
- sellVolume4: String
5187
- """The sell volume in USD in the past 5 minutes."""
5188
- sellVolume5m: String
5189
- """The total pool fees in USD in the past 5 minutes."""
5190
- poolFees5m: String
5191
- """The total pool fees in USD in the past hour."""
5192
- poolFees1: String
5193
- """The total pool fees in USD in the past 4 hours."""
5194
- poolFees4: String
5195
- """The total pool fees in USD in the past 12 hours."""
5196
- poolFees12: String
5197
- """The total pool fees in USD in the past 24 hours."""
5198
- poolFees24: String
5199
- """The total base gas fees in USD in the past 5 minutes."""
5200
- baseFees5m: String
5201
- """The total base gas fees in USD in the past hour."""
5202
- baseFees1: String
5203
- """The total base gas fees in USD in the past 4 hours."""
5204
- baseFees4: String
5205
- """The total base gas fees in USD in the past 12 hours."""
5206
- baseFees12: String
5207
- """The total base gas fees in USD in the past 24 hours."""
5208
- baseFees24: String
5209
- """The total priority fees in USD in the past 5 minutes."""
5210
- priorityFees5m: String
5211
- """The total priority fees in USD in the past hour."""
5212
- priorityFees1: String
5213
- """The total priority fees in USD in the past 4 hours."""
5214
- priorityFees4: String
5215
- """The total priority fees in USD in the past 12 hours."""
5216
- priorityFees12: String
5217
- """The total priority fees in USD in the past 24 hours."""
5218
- priorityFees24: String
5219
- """The total builder tips (MEV) in USD in the past 5 minutes."""
5220
- builderTips5m: String
5221
- """The total builder tips (MEV) in USD in the past hour."""
5222
- builderTips1: String
5223
- """The total builder tips (MEV) in USD in the past 4 hours."""
5224
- builderTips4: String
5225
- """The total builder tips (MEV) in USD in the past 12 hours."""
5226
- builderTips12: String
5227
- """The total builder tips (MEV) in USD in the past 24 hours."""
5228
- builderTips24: String
5229
- """The total L1 data fees in USD in the past 5 minutes."""
5230
- l1DataFees5m: String
5231
- """The total L1 data fees in USD in the past hour."""
5232
- l1DataFees1: String
5233
- """The total L1 data fees in USD in the past 4 hours."""
5234
- l1DataFees4: String
5235
- """The total L1 data fees in USD in the past 12 hours."""
5236
- l1DataFees12: String
5237
- """The total L1 data fees in USD in the past 24 hours."""
5238
- l1DataFees24: String
5239
- """The total trading fees (pool + gas + tips) in USD in the past 5 minutes."""
5240
- totalFees5m: String
5241
- """The total trading fees (pool + gas + tips) in USD in the past hour."""
5242
- totalFees1: String
5243
- """The total trading fees (pool + gas + tips) in USD in the past 4 hours."""
5244
- totalFees4: String
5245
- """The total trading fees (pool + gas + tips) in USD in the past 12 hours."""
5246
- totalFees12: String
5247
- """The total trading fees (pool + gas + tips) in USD in the past 24 hours."""
5248
- totalFees24: String
5249
- """The ratio of total fees to volume in the past 5 minutes. Decimal format."""
5250
- feeToVolumeRatio5m: String
5251
- """The ratio of total fees to volume in the past hour. Decimal format."""
5252
- feeToVolumeRatio1: String
5253
- """The ratio of total fees to volume in the past 4 hours. Decimal format."""
5254
- feeToVolumeRatio4: String
5255
- """The ratio of total fees to volume in the past 12 hours. Decimal format."""
5256
- feeToVolumeRatio12: String
5257
- """The ratio of total fees to volume in the past 24 hours. Decimal format."""
5258
- feeToVolumeRatio24: String
5259
- """Whether the token has been flagged as a scam."""
5260
- isScam: Boolean
5261
- """The number of different wallets holding the token."""
5262
- holders: Int
5263
- """The average age of the wallets that traded in the last 24h"""
5264
- walletAgeAvg: String
5265
- """The standard deviation of age of the wallets that traded in the last 24h"""
5266
- walletAgeStd: String
5267
- """The percentage of wallets that are less than 1d old that have traded in the last 24h"""
5268
- swapPct1dOldWallet: String
5269
- """The percentage of wallets that are less than 7d old that have traded in the last 24h"""
5270
- swapPct7dOldWallet: String
5271
- """The number of wallets that have sniped the token. Null for a token `tokenWalletStats` does not cover."""
5272
- sniperCount: Int
5273
- """The percentage of tokens held by snipers. Null for a token `tokenWalletStats` does not cover."""
5274
- sniperHeldPercentage: Float
5275
- """The number of wallets that have bundled the token. Null for a token `tokenWalletStats` does not cover."""
5276
- bundlerCount: Int
5277
- """The percentage of tokens held by bundlers. Null for a token `tokenWalletStats` does not cover."""
5278
- bundlerHeldPercentage: Float
5279
- """The number of wallets that have been an insider of the token. Null for a token `tokenWalletStats` does not cover."""
5280
- insiderCount: Int
5281
- """The percentage of tokens held by insiders. Null for a token `tokenWalletStats` does not cover."""
5282
- insiderHeldPercentage: Float
5283
- """The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders). Null for a token `tokenWalletStats` does not cover."""
5284
- suspiciousCount: Int
5285
- """The percentage of tokens held by suspicious wallets. Null for a token `tokenWalletStats` does not cover."""
5286
- suspiciousHeldPercentage: Float
5287
- """The percentage of tokens held by the dev. Null for a token `tokenWalletStats` does not cover."""
5288
- devHeldPercentage: Float
5289
- """The percentage of total supply held by the top 10 holders."""
5290
- top10HoldersPercent: Float
5291
- """The reasons the token has been flagged as a potential scam."""
5292
- potentialScamReasons: [PotentialScamReason]
5293
- """The all-time high price in USD."""
5294
- athPrice: String
5295
- """The unix timestamp when the all-time high price was reached."""
5296
- athPriceTimestamp: Int
5297
- """The all-time low price in USD."""
5298
- atlPrice: String
5299
- """The unix timestamp when the all-time low price was reached."""
5300
- atlPriceTimestamp: Int
5301
- """The all-time high fully diluted market cap."""
5302
- athFdv: String
5303
- """The unix timestamp when the all-time high FDV was reached."""
5304
- athFdvTimestamp: Int
5305
- """The all-time low fully diluted market cap."""
5306
- atlFdv: String
5307
- """The unix timestamp when the all-time low FDV was reached."""
5308
- atlFdvTimestamp: Int
5309
- """The all-time high circulating market cap."""
5310
- athCircMc: String
5311
- """The unix timestamp when the all-time high circulating market cap was reached."""
5312
- athCircMcTimestamp: Int
5313
- """The all-time low circulating market cap."""
5314
- atlCircMc: String
5315
- """The unix timestamp when the all-time low circulating market cap was reached."""
5316
- atlCircMcTimestamp: Int
4808
+ """A price value pair containing both USD and collateral token prices."""
4809
+ type PriceValuePair {
4810
+ """Price in USD."""
4811
+ usd: String!
4812
+ """Price in collateral token units."""
4813
+ ct: String!
5317
4814
  }
5318
4815
 
5319
- """Metadata for a contract."""
5320
- union EnhancedContract = EnhancedToken | EnhancedNftContract
4816
+ """OHLC (Open/High/Low/Close) values for prices."""
4817
+ type PriceOHLC {
4818
+ """Opening price."""
4819
+ open: PriceValuePair!
4820
+ """Closing price."""
4821
+ close: PriceValuePair!
4822
+ """Low price."""
4823
+ low: PriceValuePair!
4824
+ """High price."""
4825
+ high: PriceValuePair!
4826
+ }
5321
4827
 
5322
- """Community gathered proposals for an asset."""
5323
- type CommunityNote {
5324
- """The contract address of the contract."""
5325
- address: String!
5326
- contractType: ContractType!
5327
- currentContract: EnhancedContract
5328
- """The contract after the community note was applied."""
5329
- currentData: JSON
5330
- """The ID of the contract (`address:id`)."""
5331
- id: String!
5332
- """The unix timestamp of when the community note was moderated."""
5333
- moderatedAt: Int
5334
- """The network ID the contract is deployed on."""
5335
- networkId: Int!
5336
- """The contract before the community note was applied."""
5337
- previousData: JSON
5338
- """The data of the community note."""
5339
- proposalData: JSON!
5340
- """The ordinal number of the community note."""
5341
- proposalNum: Int!
5342
- """The type of the community note."""
5343
- proposalType: CommunityNoteType!
5344
- """The unix timestamp of when the community note was created."""
5345
- proposedAt: Int!
5346
- """The status of the community note."""
5347
- status: ContractProposalStatus!
5348
- sortKey: String!
4828
+ """All-time stats containing volume data."""
4829
+ type WindowedPredictionAllTimeStats {
4830
+ """Total volume."""
4831
+ volume: CurrencyValuePair!
4832
+ """Venue-specific volume (optional)."""
4833
+ venueVolume: CurrencyValuePair
5349
4834
  }
5350
4835
 
5351
- """Metadata for a decentralized exchange."""
5352
- type Exchange {
5353
- """The ID of the exchange (`address:id`)."""
5354
- id: String!
5355
- """The contract address of the exchange."""
5356
- address: String!
5357
- """The hex string for the exchange color."""
5358
- color: String
5359
- """The name of the exchange."""
5360
- name: String
5361
- """The version of the exchange, if applicable."""
5362
- exchangeVersion: String
5363
- """The exchange logo URL."""
5364
- iconUrl: String
5365
- """The network ID the exchange is deployed on."""
5366
- networkId: Int!
5367
- """The URL for the exchange."""
5368
- tradeUrl: String
4836
+ """Core market stats that are always available."""
4837
+ type WindowedPredictionMarketCoreStats {
4838
+ """Volume during this window."""
4839
+ volume: CurrencyValuePair!
4840
+ """Number of trades during this window."""
4841
+ trades: Int!
5369
4842
  }
5370
4843
 
5371
- """Filters for community notes."""
5372
- input CommunityNotesFilter {
5373
- """The contract address of the contract."""
5374
- address: String
5375
- contractType: ContractType
5376
- """The network ID the contract is deployed on."""
5377
- networkId: [Int]
5378
- """The type of the proposal."""
5379
- proposalType: CommunityNoteType
4844
+ """Unique trader count during the period."""
4845
+ type WindowedPredictionMarketUniqueTraderStats {
4846
+ """Number of unique traders."""
4847
+ uniqueTraders: Int!
5380
4848
  }
5381
4849
 
5382
- """Input type of `getCommunityNotes`."""
5383
- input CommunityNotesInput {
5384
- """A set of filters to apply"""
5385
- filter: CommunityNotesFilter
5386
- """The maximum number of community notes to return."""
5387
- limit: Int
5388
- """The cursor to use for pagination."""
5389
- cursor: String
4850
+ """Market-level liquidity OHLC data."""
4851
+ type WindowedPredictionMarketLiquidityStats {
4852
+ """Liquidity OHLC values."""
4853
+ liquidity: CurrencyOHLC!
5390
4854
  }
5391
4855
 
5392
- """Community notes data."""
5393
- type CommunityNotesResponse {
5394
- """The list of community notes matching the filter parameters."""
5395
- items: [CommunityNote!]!
5396
- """The number of community notes returned."""
5397
- count: Int!
5398
- """A cursor for use in pagination."""
5399
- cursor: String
4856
+ """Market-level open interest OHLC data."""
4857
+ type WindowedPredictionMarketOpenInterestStats {
4858
+ """Open interest OHLC values."""
4859
+ openInterest: CurrencyOHLC!
5400
4860
  }
5401
4861
 
5402
- """Metadata for a wallet label from the WALLET_LABEL_TYPES vocabulary"""
5403
- type WalletLabelType {
5404
- """Label name (e.g. WHALE, CEX, KOL)"""
5405
- name: String!
5406
- """Human-readable display name"""
5407
- displayName: String!
5408
- """Description of what this label means"""
5409
- description: String!
5410
- }
5411
-
5412
- """A prediction sub-subcategory (3rd level, terminal)."""
5413
- type PredictionSubSubcategory {
5414
- """The display name."""
5415
- name: String!
5416
- """The URL slug."""
5417
- slug: String!
5418
- }
5419
-
5420
- """A prediction subcategory (2nd level)."""
5421
- type PredictionSubcategory {
5422
- """The display name."""
5423
- name: String!
5424
- """The URL slug."""
5425
- slug: String!
5426
- """Nested subcategories (3rd level)."""
5427
- subcategories: [PredictionSubSubcategory!]
5428
- }
5429
-
5430
- """A prediction category with optional nested subcategories."""
5431
- type PredictionCategory {
5432
- """The display name."""
5433
- name: String!
5434
- """The URL slug."""
5435
- slug: String!
5436
- """Nested subcategories (2nd level)."""
5437
- subcategories: [PredictionSubcategory!]
5438
- }
5439
-
5440
- """The duration used to request windowed prediction stats."""
5441
- enum PredictionStatsDuration {
5442
- week1
5443
- day1
5444
- hour12
5445
- hour4
5446
- hour1
5447
- min5
5448
- }
5449
-
5450
- """Input type of `detailedPredictionMarketStats`."""
5451
- input DetailedPredictionMarketStatsInput {
5452
- """The ID of the prediction market."""
5453
- marketId: String!
5454
- """The unix timestamp."""
5455
- timestamp: Int
5456
- """The stat durations to include."""
5457
- durations: [PredictionStatsDuration!]
5458
- """The number of stat buckets to return."""
5459
- bucketCount: Int
5460
- }
5461
-
5462
- """A currency value pair containing both USD and collateral token values."""
5463
- type CurrencyValuePair {
5464
- """Value in USD."""
5465
- usd: String!
5466
- """Value in collateral token units."""
5467
- ct: String!
5468
- }
5469
-
5470
- """OHLC (Open/High/Low/Close) values for a currency pair."""
5471
- type CurrencyOHLC {
5472
- """Opening value."""
5473
- open: CurrencyValuePair!
5474
- """Closing value."""
5475
- close: CurrencyValuePair!
5476
- """Low value."""
5477
- low: CurrencyValuePair!
5478
- """High value."""
5479
- high: CurrencyValuePair!
5480
- }
5481
-
5482
- """A price value pair containing both USD and collateral token prices."""
5483
- type PriceValuePair {
5484
- """Price in USD."""
5485
- usd: String!
5486
- """Price in collateral token units."""
5487
- ct: String!
5488
- }
5489
-
5490
- """OHLC (Open/High/Low/Close) values for prices."""
5491
- type PriceOHLC {
5492
- """Opening price."""
5493
- open: PriceValuePair!
5494
- """Closing price."""
5495
- close: PriceValuePair!
5496
- """Low price."""
5497
- low: PriceValuePair!
5498
- """High price."""
5499
- high: PriceValuePair!
5500
- }
5501
-
5502
- """All-time stats containing volume data."""
5503
- type WindowedPredictionAllTimeStats {
5504
- """Total volume."""
5505
- volume: CurrencyValuePair!
5506
- """Venue-specific volume (optional)."""
5507
- venueVolume: CurrencyValuePair
5508
- }
5509
-
5510
- """Core market stats that are always available."""
5511
- type WindowedPredictionMarketCoreStats {
5512
- """Volume during this window."""
5513
- volume: CurrencyValuePair!
5514
- """Number of trades during this window."""
5515
- trades: Int!
5516
- }
5517
-
5518
- """Unique trader count during the period."""
5519
- type WindowedPredictionMarketUniqueTraderStats {
5520
- """Number of unique traders."""
5521
- uniqueTraders: Int!
5522
- }
5523
-
5524
- """Market-level liquidity OHLC data."""
5525
- type WindowedPredictionMarketLiquidityStats {
5526
- """Liquidity OHLC values."""
5527
- liquidity: CurrencyOHLC!
5528
- }
5529
-
5530
- """Market-level open interest OHLC data."""
5531
- type WindowedPredictionMarketOpenInterestStats {
5532
- """Open interest OHLC values."""
5533
- openInterest: CurrencyOHLC!
5534
- }
5535
-
5536
- """Change percentages for a prediction market over a time window."""
5537
- type WindowedPredictionMarketChangeStats {
5538
- """Volume change percentage."""
5539
- volumeChange: Float!
5540
- """Trades change percentage."""
5541
- tradesChange: Float!
5542
- """Unique traders change percentage (optional)."""
5543
- uniqueTradersChange: Float
5544
- """Liquidity change percentage (optional)."""
5545
- liquidityChange: Float
5546
- """Open interest change percentage (optional)."""
5547
- openInterestChange: Float
4862
+ """Change percentages for a prediction market over a time window."""
4863
+ type WindowedPredictionMarketChangeStats {
4864
+ """Volume change percentage."""
4865
+ volumeChange: Float!
4866
+ """Trades change percentage."""
4867
+ tradesChange: Float!
4868
+ """Unique traders change percentage (optional)."""
4869
+ uniqueTradersChange: Float
4870
+ """Liquidity change percentage (optional)."""
4871
+ liquidityChange: Float
4872
+ """Open interest change percentage (optional)."""
4873
+ openInterestChange: Float
5548
4874
  }
5549
4875
 
5550
4876
  """Volume breakdown including shares for an outcome."""
@@ -10757,185 +10083,860 @@ type ComparisonOperator {
10757
10083
  eq: String
10758
10084
  }
10759
10085
 
10760
- """String equals condition."""
10761
- type StringEqualsCondition {
10762
- """The string to equal."""
10763
- eq: String!
10764
- }
10086
+ """String equals condition."""
10087
+ type StringEqualsCondition {
10088
+ """The string to equal."""
10089
+ eq: String!
10090
+ }
10091
+
10092
+ """Integer equals condition."""
10093
+ type IntEqualsCondition {
10094
+ """The integer to equal."""
10095
+ eq: Int!
10096
+ }
10097
+
10098
+ """A network supported on Defined."""
10099
+ type Network {
10100
+ """The name of the network. For example, `arbitrum`."""
10101
+ name: String!
10102
+ """The network ID. For example, `42161` for `arbitrum`."""
10103
+ id: Int!
10104
+ networkShortName: String
10105
+ }
10106
+
10107
+ """The status for a network supported on Defined."""
10108
+ type MetadataResponse {
10109
+ """The last processed block on the network."""
10110
+ lastProcessedBlock: Int
10111
+ """The unix timestamp for the last processed block on the network."""
10112
+ lastProcessedTimestamp: Int
10113
+ """The network ID."""
10114
+ networkId: Int!
10115
+ """The name of the network."""
10116
+ networkName: String!
10117
+ """Transactions per second, averaged over the network's latest indexed blocks (up to 500 blocks from the past 5 minutes). Refreshed every 5 minutes. Null when fewer than two blocks were indexed in that window. On Solana-based networks it counts every executed transaction, including failed and vote transactions."""
10118
+ transactionsPerSecond: Float
10119
+ }
10120
+
10121
+ input BlocksInput {
10122
+ networkId: Int!
10123
+ blockNumbers: [Int!]
10124
+ timestamps: [Int!]
10125
+ }
10126
+
10127
+ type Block {
10128
+ blockNumber: Int!
10129
+ timestamp: Int!
10130
+ hash: String!
10131
+ }
10132
+
10133
+ """A wallet matching a filter."""
10134
+ type WalletFilterResult {
10135
+ """The wallet address"""
10136
+ address: String!
10137
+ """The network ID of the wallet (only present if filtered by network)"""
10138
+ networkId: Int
10139
+ """The unix timestamp for the first transaction from this wallet"""
10140
+ firstTransactionAt: Int
10141
+ """The unix timestamp for the last transaction from this wallet"""
10142
+ lastTransactionAt: Int!
10143
+ """The labels associated with the wallet"""
10144
+ labels: [String!]!
10145
+ """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)."""
10146
+ identityLabels: [String!]
10147
+ """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."""
10148
+ tradeSourceIds: [String!]
10149
+ """Volume in USD in the past day"""
10150
+ volumeUsd1d: String!
10151
+ """Total volume in USD in the past day including all tokens"""
10152
+ volumeUsdAll1d: String!
10153
+ """Realized profit in USD in the past day"""
10154
+ realizedProfitUsd1d: String!
10155
+ """Realized profit in USD excluding native tokens in the past day. Tracking began July 2, 2026; null for index records written before then."""
10156
+ realizedProfitUsdExNative1d: String
10157
+ """Average profit in USD per trade in the past day"""
10158
+ averageProfitUsdPerTrade1d: String!
10159
+ """Average swap amount in USD in the past day"""
10160
+ averageSwapAmountUsd1d: String!
10161
+ """Realized profit percentage in the past day"""
10162
+ realizedProfitPercentage1d: Float!
10163
+ """Realized profit percentage excluding native tokens in the past day. Tracking began July 2, 2026; null for index records written before then."""
10164
+ realizedProfitPercentageExNative1d: Float
10165
+ """Average hold period, in seconds, for positions sold during the past day. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold."""
10166
+ avgHoldPeriodSec1d: Float
10167
+ """Number of swaps in the past day"""
10168
+ swaps1d: Int!
10169
+ """Total number of swaps in the past day including all tokens"""
10170
+ swapsAll1d: Int!
10171
+ """Number of unique tokens traded in the past day"""
10172
+ uniqueTokens1d: Int!
10173
+ """Win rate in the past day"""
10174
+ winRate1d: Float!
10175
+ """Volume in USD in the past week"""
10176
+ volumeUsd1w: String!
10177
+ """Total volume in USD in the past week including all tokens"""
10178
+ volumeUsdAll1w: String!
10179
+ """Realized profit in USD in the past week"""
10180
+ realizedProfitUsd1w: String!
10181
+ """Realized profit in USD excluding native tokens in the past week. Tracking began July 2, 2026; null for index records written before then."""
10182
+ realizedProfitUsdExNative1w: String
10183
+ """Average profit in USD per trade in the past week"""
10184
+ averageProfitUsdPerTrade1w: String!
10185
+ """Average swap amount in USD in the past week"""
10186
+ averageSwapAmountUsd1w: String!
10187
+ """Realized profit percentage in the past week"""
10188
+ realizedProfitPercentage1w: Float!
10189
+ """Realized profit percentage excluding native tokens in the past week. Tracking began July 2, 2026; null for index records written before then."""
10190
+ realizedProfitPercentageExNative1w: Float
10191
+ """Average hold period, in seconds, for positions sold during the past week. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold."""
10192
+ avgHoldPeriodSec1w: Float
10193
+ """Number of swaps in the past week"""
10194
+ swaps1w: Int!
10195
+ """Total number of swaps in the past week including all tokens"""
10196
+ swapsAll1w: Int!
10197
+ """Number of unique tokens traded in the past week"""
10198
+ uniqueTokens1w: Int!
10199
+ """Win rate in the past week"""
10200
+ winRate1w: Float!
10201
+ """Volume in USD in the past 30 days"""
10202
+ volumeUsd30d: String!
10203
+ """Total volume in USD in the past 30 days including all tokens"""
10204
+ volumeUsdAll30d: String!
10205
+ """Realized profit in USD in the past 30 days"""
10206
+ realizedProfitUsd30d: String!
10207
+ """Realized profit in USD excluding native tokens in the past 30 days. Tracking began July 2, 2026; null for index records written before then."""
10208
+ realizedProfitUsdExNative30d: String
10209
+ """Average profit in USD per trade in the past 30 days"""
10210
+ averageProfitUsdPerTrade30d: String!
10211
+ """Average swap amount in USD in the past 30 days"""
10212
+ averageSwapAmountUsd30d: String!
10213
+ """Realized profit percentage in the past 30 days"""
10214
+ realizedProfitPercentage30d: Float!
10215
+ """Realized profit percentage excluding native tokens in the past 30 days. Tracking began July 2, 2026; null for index records written before then."""
10216
+ realizedProfitPercentageExNative30d: Float
10217
+ """Average hold period, in seconds, for positions sold during the past 30 days. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold."""
10218
+ avgHoldPeriodSec30d: Float
10219
+ """Number of swaps in the past 30 days"""
10220
+ swaps30d: Int!
10221
+ """Total number of swaps in the past 30 days including all tokens"""
10222
+ swapsAll30d: Int!
10223
+ """Number of unique tokens traded in the past 30 days"""
10224
+ uniqueTokens30d: Int!
10225
+ """Win rate in the past 30 days"""
10226
+ winRate30d: Float!
10227
+ """Volume in USD in the past year"""
10228
+ volumeUsd1y: String!
10229
+ """Total volume in USD in the past year including all tokens"""
10230
+ volumeUsdAll1y: String!
10231
+ """Realized profit in USD in the past year"""
10232
+ realizedProfitUsd1y: String!
10233
+ """Average profit in USD per trade in the past year"""
10234
+ averageProfitUsdPerTrade1y: String!
10235
+ """Average swap amount in USD in the past year"""
10236
+ averageSwapAmountUsd1y: String!
10237
+ """Realized profit percentage in the past year"""
10238
+ realizedProfitPercentage1y: Float!
10239
+ """Average hold period, in seconds, for positions sold during the past year. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold."""
10240
+ avgHoldPeriodSec1y: Float
10241
+ """Number of swaps in the past year"""
10242
+ swaps1y: Int!
10243
+ """Total number of swaps in the past year including all tokens"""
10244
+ swapsAll1y: Int!
10245
+ """Number of unique tokens traded in the past year"""
10246
+ uniqueTokens1y: Int! @deprecated(reason: "uniqueTokens1y is no longer available as a distinct 1-year value; it now reflects the 30-day value (uniqueTokens30d).")
10247
+ """Win rate in the past year"""
10248
+ winRate1y: Float!
10249
+ """The scammer score for the wallet."""
10250
+ scammerScore: Int
10251
+ """The bot score for the wallet."""
10252
+ botScore: Int
10253
+ """Total number of tokens created by this wallet across all networks."""
10254
+ tokensCreatedCount: Int
10255
+ """Total number of launchpad tokens migrated (graduated) by this wallet across all networks."""
10256
+ tokensMigratedCount: Int
10257
+ """Wallet behavior classification. Null is equivalent to NORMIE."""
10258
+ category: WalletCategory
10259
+ """The native token balance of the wallet (only present if filtered by network)"""
10260
+ nativeTokenBalance: String
10261
+ """The backfill state of the wallet."""
10262
+ backfillState: WalletAggregateBackfillState
10263
+ """The wallet identity and profile data"""
10264
+ wallet: Wallet
10265
+ }
10266
+
10267
+ scalar Void
10268
+
10269
+ """Type of the community gathered note."""
10270
+ enum CommunityNoteType {
10271
+ """An contract attribute change."""
10272
+ ATTRIBUTE
10273
+ """A scam report."""
10274
+ SCAM
10275
+ """A logo change."""
10276
+ LOGO
10277
+ }
10278
+
10279
+ """Type of the contract."""
10280
+ enum ContractType {
10281
+ TOKEN
10282
+ WALLET
10283
+ }
10284
+
10285
+ enum ContractProposalStatus {
10286
+ ACCEPTED
10287
+ PENDING
10288
+ REJECTED
10289
+ REVERTED
10290
+ }
10291
+
10292
+ """The attribute used to rank tokens."""
10293
+ enum TokenRankingAttribute {
10294
+ """Weighted risk score."""
10295
+ riskScore
10296
+ """Unix seconds of the token's latest recorded risk change."""
10297
+ riskFlaggedAt
10298
+ createdAt
10299
+ tokenCreatedAt
10300
+ lastTransaction
10301
+ age @deprecated(reason: "Use createdAt instead")
10302
+ buyCount5m
10303
+ buyCount1
10304
+ buyCount4
10305
+ buyCount12
10306
+ buyCount24
10307
+ change5m
10308
+ change1
10309
+ change4
10310
+ change12
10311
+ change24
10312
+ volumeChange5m
10313
+ volumeChange1
10314
+ volumeChange4
10315
+ volumeChange12
10316
+ volumeChange24
10317
+ high5m
10318
+ high1
10319
+ high4
10320
+ high12
10321
+ high24
10322
+ holders
10323
+ notableHolderCount
10324
+ liquidity
10325
+ totalLiquidityUsd
10326
+ low5m
10327
+ low1
10328
+ low4
10329
+ low12
10330
+ low24
10331
+ marketCap
10332
+ circulatingMarketCap
10333
+ priceUSD
10334
+ sellCount5m
10335
+ sellCount1
10336
+ sellCount4
10337
+ sellCount12
10338
+ sellCount24
10339
+ trendingScore
10340
+ trendingScore5m
10341
+ trendingScore1
10342
+ trendingScore4
10343
+ trendingScore12
10344
+ trendingScore24
10345
+ txnCount5m
10346
+ txnCount1
10347
+ txnCount4
10348
+ txnCount12
10349
+ txnCount24
10350
+ uniqueBuys5m
10351
+ uniqueBuys1
10352
+ uniqueBuys4
10353
+ uniqueBuys12
10354
+ uniqueBuys24
10355
+ uniqueSells5m
10356
+ uniqueSells1
10357
+ uniqueSells4
10358
+ uniqueSells12
10359
+ uniqueSells24
10360
+ uniqueTransactions5m
10361
+ uniqueTransactions1
10362
+ uniqueTransactions4
10363
+ uniqueTransactions12
10364
+ uniqueTransactions24
10365
+ volume5m
10366
+ volume1
10367
+ volume4
10368
+ volume12
10369
+ volume24
10370
+ buyVolume5m
10371
+ buyVolume1
10372
+ buyVolume4
10373
+ buyVolume12
10374
+ buyVolume24
10375
+ sellVolume5m
10376
+ sellVolume1
10377
+ sellVolume4
10378
+ sellVolume12
10379
+ sellVolume24
10380
+ poolFees5m
10381
+ poolFees1
10382
+ poolFees4
10383
+ poolFees12
10384
+ poolFees24
10385
+ baseFees5m
10386
+ baseFees1
10387
+ baseFees4
10388
+ baseFees12
10389
+ baseFees24
10390
+ priorityFees5m
10391
+ priorityFees1
10392
+ priorityFees4
10393
+ priorityFees12
10394
+ priorityFees24
10395
+ builderTips5m
10396
+ builderTips1
10397
+ builderTips4
10398
+ builderTips12
10399
+ builderTips24
10400
+ l1DataFees5m
10401
+ l1DataFees1
10402
+ l1DataFees4
10403
+ l1DataFees12
10404
+ l1DataFees24
10405
+ totalFees5m
10406
+ totalFees1
10407
+ totalFees4
10408
+ totalFees12
10409
+ totalFees24
10410
+ feeToVolumeRatio5m
10411
+ feeToVolumeRatio1
10412
+ feeToVolumeRatio4
10413
+ feeToVolumeRatio12
10414
+ feeToVolumeRatio24
10415
+ launchpadCompletedAt
10416
+ launchpadMigratedAt
10417
+ graduationPercent
10418
+ walletAgeAvg
10419
+ walletAgeStd
10420
+ swapPct1dOldWallet
10421
+ swapPct7dOldWallet
10422
+ sniperHeldPercentage
10423
+ bundlerHeldPercentage
10424
+ insiderHeldPercentage
10425
+ suspiciousHeldPercentage
10426
+ sniperCount
10427
+ bundlerCount
10428
+ insiderCount
10429
+ suspiciousCount
10430
+ devHeldPercentage
10431
+ top10HoldersPercent
10432
+ coinCommunityPostCount
10433
+ coinCommunityMemberCount
10434
+ coinCommunityLikeCount
10435
+ coinCommunityLastPostAt
10436
+ }
10437
+
10438
+ """Input type of `TokenRanking`."""
10439
+ input TokenRanking {
10440
+ """The attribute to rank tokens by."""
10441
+ attribute: TokenRankingAttribute
10442
+ """The direction to apply to the ranking attribute."""
10443
+ direction: RankingDirection
10444
+ }
10445
+
10446
+ """Real-time or historical prices for a token."""
10447
+ type Price {
10448
+ """The contract address of the token."""
10449
+ address: String!
10450
+ """The unix timestamp for the price."""
10451
+ timestamp: Int
10452
+ """The network ID the token is deployed on."""
10453
+ networkId: Int!
10454
+ """The token price in USD."""
10455
+ priceUsd: Float!
10456
+ """The pool that emitted the swap generating this price"""
10457
+ blockNumber: Int
10458
+ """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. On subscriptions it is the `totalLiquidityUsd` value only, refreshed at most every 30 seconds, and null on networks where the real-money total is not enabled."""
10459
+ liquidityUsd: String
10460
+ """The percent price change in the past 24 hours. Decimal format. Not available via subscription."""
10461
+ priceChange24: Float
10462
+ """The pool that emitted the swap generating this price"""
10463
+ poolAddress: String @deprecated(reason: "Pricing no longer based on specific pools")
10464
+ """Ratio of how confident we are in the price"""
10465
+ confidence: Float @deprecated(reason: "Pricing no longer based on specific pools")
10466
+ }
10467
+
10468
+ """Metadata for a token."""
10469
+ type EnhancedToken {
10470
+ """The ID of the token (`address:networkId`)."""
10471
+ id: String!
10472
+ """The contract address of the token."""
10473
+ address: String!
10474
+ """The token ID on CoinMarketCap."""
10475
+ cmcId: Int
10476
+ """The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals)."""
10477
+ decimals: Int!
10478
+ """Whether the token has been flagged as a scam."""
10479
+ isScam: Boolean
10480
+ """The token name. For example, `ApeCoin`."""
10481
+ name: String
10482
+ """The network ID the token is deployed on."""
10483
+ networkId: Int!
10484
+ """The token symbol. For example, `APE`."""
10485
+ symbol: String
10486
+ """The total supply of the token."""
10487
+ totalSupply: String @deprecated(reason: "Use the TokenInfo type")
10488
+ """Community gathered links for the socials of this token."""
10489
+ socialLinks: SocialLinks
10490
+ """More metadata about the token."""
10491
+ info: TokenInfo
10492
+ """The Grid asset ID, if this token is linked to a Grid asset."""
10493
+ gridAssetId: String
10494
+ """The Grid bluechip rating for this token (e.g. `A+`, `B-`)."""
10495
+ bluechipRating: String
10496
+ """The Grid organization associated with this token. Null when the token is reached through `AssetDeployment.token`."""
10497
+ organization: Organization
10498
+ """The Grid asset associated with this token. Null when the token is reached through `AssetDeployment.token`."""
10499
+ asset: Asset
10500
+ """Information about the token from 3rd party sources."""
10501
+ explorerData: ExplorerTokenData @deprecated(reason: "Use the TokenInfo type")
10502
+ """A list of exchanges where the token has been traded."""
10503
+ exchanges: [Exchange!]
10504
+ """The thumbnail token logo URL."""
10505
+ imageThumbUrl: String @deprecated(reason: "Use the TokenInfo type")
10506
+ """The small token logo URL."""
10507
+ imageSmallUrl: String @deprecated(reason: "Use the TokenInfo type")
10508
+ """The large token logo URL."""
10509
+ imageLargeUrl: String @deprecated(reason: "Use the TokenInfo type")
10510
+ """The circulating supply of the token."""
10511
+ circulatingSupply: String @deprecated(reason: "Use the TokenInfo type")
10512
+ """The amount of this token in the pair."""
10513
+ pooled: String @deprecated(reason: "Pooled can be found on the pair instead")
10514
+ """The token creator's wallet address."""
10515
+ creatorAddress: String
10516
+ """The token creator's wallet identity and profile, resolved from creatorAddress. Null when the token has no known creator."""
10517
+ creator: Wallet
10518
+ """The token creator's network-based token balance at time of contract creation."""
10519
+ creatorBalanceNBT: String
10520
+ """The block height the token was created at."""
10521
+ createBlockNumber: Int
10522
+ """The transaction hash of the token's creation."""
10523
+ createTransactionHash: String
10524
+ """The unix timestamp for the creation of the token."""
10525
+ createdAt: Int
10526
+ """Returns mint authority address if token is mintable. If null, verify against isMintableValid."""
10527
+ mintable: String
10528
+ """Returns freeze authority address if token is freezable. If null, verify against isFreezableValid."""
10529
+ freezable: String
10530
+ """Determines if freezable is a valid address or null value for the authority, or if the freezable state has not yet been determined."""
10531
+ isFreezableValid: Boolean
10532
+ """Determines if mintable is a valid address or null value for the authority, or if the mintable state has not yet been determined."""
10533
+ isMintableValid: Boolean
10534
+ """The launchpad data for the token, if applicable."""
10535
+ launchpad: LaunchpadData
10536
+ """The percentage of total supply held by the top 10 holders (excluding exchanges/pairs)."""
10537
+ top10HoldersPercent: Float
10538
+ """Whether the token name or symbol contains profanity."""
10539
+ profanity: Boolean
10540
+ """All-time high and low price/market cap data for the token."""
10541
+ extrema: TokenExtrema
10542
+ """The Coin Community data for the token"""
10543
+ coinCommunity: CoinCommunity
10544
+ """Token extension metadata, if available."""
10545
+ extensions: TokenExtensions
10546
+ """Token-standard-specific custom metadata — currently ERC-7572 `contractURI` fields, as used by Base B20 tokens. Null for tokens without a recognized token standard."""
10547
+ tokenStandardCustomData: Erc7572CustomInfo
10548
+ categories: [Category!]
10549
+ """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`."""
10550
+ risk: TokenRisk
10551
+ """The issuer of a real-world-asset token, such as a tokenized stock. Null when the token has no known issuer."""
10552
+ issuer: TokenIssuer
10553
+ }
10554
+
10555
+ """A token matching a set of filter parameters."""
10556
+ type TokenFilterResult {
10557
+ """Metadata for the token."""
10558
+ token: EnhancedToken
10559
+ """The unix timestamp for the creation of the token's first pair."""
10560
+ createdAt: Int
10561
+ """The unix timestamp for the token's last transaction."""
10562
+ lastTransaction: Int
10563
+ age: Int @deprecated(reason: "Age isn't supported - use createdAt instead")
10564
+ """The number of buys in the past 5 minutes."""
10565
+ buyCount5m: Int
10566
+ """The number of buys in the past hour."""
10567
+ buyCount1: Int
10568
+ """The number of buys in the past 12 hours."""
10569
+ buyCount12: Int
10570
+ """The number of buys in the past 24 hours."""
10571
+ buyCount24: Int
10572
+ """The number of buys in the past 4 hours."""
10573
+ buyCount4: Int
10574
+ """The percent price change in the past 5 minutes. Decimal format."""
10575
+ change5m: String
10576
+ """The percent price change in the past hour. Decimal format."""
10577
+ change1: String
10578
+ """The percent price change in the past 12 hours. Decimal format."""
10579
+ change12: String
10580
+ """The percent price change in the past 24 hours. Decimal format."""
10581
+ change24: String
10582
+ """The percent price change in the past 4 hours. Decimal format."""
10583
+ change4: String
10584
+ """The percent volume change in the past 5 minutes. Decimal format."""
10585
+ volumeChange5m: String
10586
+ """The percent volume change in the past hour. Decimal format."""
10587
+ volumeChange1: String
10588
+ """The percent volume change in the past 4 hours. Decimal format."""
10589
+ volumeChange4: String
10590
+ """The percent volume change in the past 12 hours. Decimal format."""
10591
+ volumeChange12: String
10592
+ """The percent volume change in the past 24 hours. Decimal format."""
10593
+ volumeChange24: String
10594
+ """The exchanges the token is listed on."""
10595
+ exchanges: [Exchange]
10596
+ fdv: String @deprecated(reason: "FDV isn't supported - use marketCap instead")
10597
+ """The highest price in USD in the past 5 minutes."""
10598
+ high5m: String
10599
+ """The highest price in USD in the past hour."""
10600
+ high1: String
10601
+ """The highest price in USD in the past 12 hours."""
10602
+ high12: String
10603
+ """The highest price in USD in the past 24 hours."""
10604
+ high24: String
10605
+ """The highest price in USD in the past 4 hours."""
10606
+ high4: String
10607
+ """The token's liquidity in USD. On networks where the real-money total is enabled, this is the same value as `totalLiquidityUsd` (the combined liquidity of its 15 deepest pools) once the token has one. On other networks it is the liquidity of the token's top pair, or with `useAggregatedStats` 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."""
10608
+ liquidity: String
10609
+ """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. On networks where the real-money total is enabled, `liquidity` is the same value; elsewhere `liquidity` covers the top pair only (or the aggregated liquidity with `useAggregatedStats`). 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."""
10610
+ totalLiquidityUsd: String
10611
+ """The token of interest. Can be `token0` or `token1`."""
10612
+ quoteToken: String
10613
+ """The lowest price in USD in the past 5 minutes."""
10614
+ low5m: String
10615
+ """The lowest price in USD in the past hour."""
10616
+ low1: String
10617
+ """The lowest price in USD in the past 12 hours."""
10618
+ low12: String
10619
+ """The lowest price in USD in the past 24 hours."""
10620
+ low24: String
10621
+ """The lowest price in USD in the past 4 hours."""
10622
+ low4: String
10623
+ """The fully diluted market cap."""
10624
+ marketCap: String
10625
+ """The circulating market cap."""
10626
+ circulatingMarketCap: String
10627
+ """Metadata for the token's top pair."""
10628
+ pair: Pair
10629
+ """Metadata for the token's most liquid pair"""
10630
+ liquidPair: Pair
10631
+ """The liquidity of the token's most liquid pair. On networks where the real-money total is enabled, this is the same value as `totalLiquidityUsd` (the combined liquidity of the token's 15 deepest pools) once the token has one. The value is recomputed when the token trades."""
10632
+ liquidPairLiquidity: String
10633
+ """The liquid pairs price in USD."""
10634
+ liquidPairPriceUSD: String
10635
+ """The token price in USD."""
10636
+ priceUSD: String
10637
+ """A heuristic based on various factors used to rank tokens based on how trending they are."""
10638
+ trendingScore: Float
10639
+ """The number of sells in the past 5 minutes."""
10640
+ sellCount5m: Int
10641
+ """The number of sells in the past hour."""
10642
+ sellCount1: Int
10643
+ """The number of sells in the past 12 hours."""
10644
+ sellCount12: Int
10645
+ """The number of sells in the past 24 hours."""
10646
+ sellCount24: Int
10647
+ """The number of sells in the past 4 hours."""
10648
+ sellCount4: Int
10649
+ """The number of transactions in the past 5 minutes."""
10650
+ txnCount5m: Int
10651
+ """The number of transactions in the past hour."""
10652
+ txnCount1: Int
10653
+ """The number of transactions in the past 12 hours."""
10654
+ txnCount12: Int
10655
+ """The number of transactions in the past 24 hours."""
10656
+ txnCount24: Int
10657
+ """The number of transactions in the past 4 hours."""
10658
+ txnCount4: Int
10659
+ """The unique number of buys in the past 5 minutes."""
10660
+ uniqueBuys5m: Int
10661
+ """The unique number of buys in the past hour."""
10662
+ uniqueBuys1: Int
10663
+ """The unique number of buys in the past 12 hours."""
10664
+ uniqueBuys12: Int
10665
+ """The unique number of buys in the past 24 hours."""
10666
+ uniqueBuys24: Int
10667
+ """The unique number of buys in the past 4 hours."""
10668
+ uniqueBuys4: Int
10669
+ """The unique number of sells in the past 5 minutes."""
10670
+ uniqueSells5m: Int
10671
+ """The unique number of sells in the past hour."""
10672
+ uniqueSells1: Int
10673
+ """The unique number of sells in the past 12 hours."""
10674
+ uniqueSells12: Int
10675
+ """The unique number of sells in the past 24 hours."""
10676
+ uniqueSells24: Int
10677
+ """The unique number of sells in the past 4 hours."""
10678
+ uniqueSells4: Int
10679
+ """The unique number of transactions in the past 5 minutes."""
10680
+ uniqueTransactions5m: Int
10681
+ """The unique number of transactions in the past hour."""
10682
+ uniqueTransactions1: Int
10683
+ """The unique number of transactions in the past 12 hours."""
10684
+ uniqueTransactions12: Int
10685
+ """The unique number of transactions in the past 24 hours."""
10686
+ uniqueTransactions24: Int
10687
+ """The unique number of transactions in the past 4 hours."""
10688
+ uniqueTransactions4: Int
10689
+ """The trade volume in USD in the past hour."""
10690
+ volume1: String
10691
+ """The trade volume in USD in the past 5 minutes."""
10692
+ volume5m: String
10693
+ """The trade volume in USD in the past 12 hours."""
10694
+ volume12: String
10695
+ """The trade volume in USD in the past 24 hours."""
10696
+ volume24: String
10697
+ """The trade volume in USD in the past 4 hours."""
10698
+ volume4: String
10699
+ """The buy volume in USD in the past hour."""
10700
+ buyVolume1: String
10701
+ """The buy volume in USD in the past 12 hours."""
10702
+ buyVolume12: String
10703
+ """The buy volume in USD in the past 24 hours."""
10704
+ buyVolume24: String
10705
+ """The buy volume in USD in the past 4 hours."""
10706
+ buyVolume4: String
10707
+ """The buy volume in USD in the past 5 minutes."""
10708
+ buyVolume5m: String
10709
+ """The sell volume in USD in the past hour."""
10710
+ sellVolume1: String
10711
+ """The sell volume in USD in the past 12 hours."""
10712
+ sellVolume12: String
10713
+ """The sell volume in USD in the past 24 hours."""
10714
+ sellVolume24: String
10715
+ """The sell volume in USD in the past 4 hours."""
10716
+ sellVolume4: String
10717
+ """The sell volume in USD in the past 5 minutes."""
10718
+ sellVolume5m: String
10719
+ """The total pool fees in USD in the past 5 minutes."""
10720
+ poolFees5m: String
10721
+ """The total pool fees in USD in the past hour."""
10722
+ poolFees1: String
10723
+ """The total pool fees in USD in the past 4 hours."""
10724
+ poolFees4: String
10725
+ """The total pool fees in USD in the past 12 hours."""
10726
+ poolFees12: String
10727
+ """The total pool fees in USD in the past 24 hours."""
10728
+ poolFees24: String
10729
+ """The total base gas fees in USD in the past 5 minutes."""
10730
+ baseFees5m: String
10731
+ """The total base gas fees in USD in the past hour."""
10732
+ baseFees1: String
10733
+ """The total base gas fees in USD in the past 4 hours."""
10734
+ baseFees4: String
10735
+ """The total base gas fees in USD in the past 12 hours."""
10736
+ baseFees12: String
10737
+ """The total base gas fees in USD in the past 24 hours."""
10738
+ baseFees24: String
10739
+ """The total priority fees in USD in the past 5 minutes."""
10740
+ priorityFees5m: String
10741
+ """The total priority fees in USD in the past hour."""
10742
+ priorityFees1: String
10743
+ """The total priority fees in USD in the past 4 hours."""
10744
+ priorityFees4: String
10745
+ """The total priority fees in USD in the past 12 hours."""
10746
+ priorityFees12: String
10747
+ """The total priority fees in USD in the past 24 hours."""
10748
+ priorityFees24: String
10749
+ """The total builder tips (MEV) in USD in the past 5 minutes."""
10750
+ builderTips5m: String
10751
+ """The total builder tips (MEV) in USD in the past hour."""
10752
+ builderTips1: String
10753
+ """The total builder tips (MEV) in USD in the past 4 hours."""
10754
+ builderTips4: String
10755
+ """The total builder tips (MEV) in USD in the past 12 hours."""
10756
+ builderTips12: String
10757
+ """The total builder tips (MEV) in USD in the past 24 hours."""
10758
+ builderTips24: String
10759
+ """The total L1 data fees in USD in the past 5 minutes."""
10760
+ l1DataFees5m: String
10761
+ """The total L1 data fees in USD in the past hour."""
10762
+ l1DataFees1: String
10763
+ """The total L1 data fees in USD in the past 4 hours."""
10764
+ l1DataFees4: String
10765
+ """The total L1 data fees in USD in the past 12 hours."""
10766
+ l1DataFees12: String
10767
+ """The total L1 data fees in USD in the past 24 hours."""
10768
+ l1DataFees24: String
10769
+ """The total trading fees (pool + gas + tips) in USD in the past 5 minutes."""
10770
+ totalFees5m: String
10771
+ """The total trading fees (pool + gas + tips) in USD in the past hour."""
10772
+ totalFees1: String
10773
+ """The total trading fees (pool + gas + tips) in USD in the past 4 hours."""
10774
+ totalFees4: String
10775
+ """The total trading fees (pool + gas + tips) in USD in the past 12 hours."""
10776
+ totalFees12: String
10777
+ """The total trading fees (pool + gas + tips) in USD in the past 24 hours."""
10778
+ totalFees24: String
10779
+ """The ratio of total fees to volume in the past 5 minutes. Decimal format."""
10780
+ feeToVolumeRatio5m: String
10781
+ """The ratio of total fees to volume in the past hour. Decimal format."""
10782
+ feeToVolumeRatio1: String
10783
+ """The ratio of total fees to volume in the past 4 hours. Decimal format."""
10784
+ feeToVolumeRatio4: String
10785
+ """The ratio of total fees to volume in the past 12 hours. Decimal format."""
10786
+ feeToVolumeRatio12: String
10787
+ """The ratio of total fees to volume in the past 24 hours. Decimal format."""
10788
+ feeToVolumeRatio24: String
10789
+ """Whether the token has been flagged as a scam."""
10790
+ isScam: Boolean
10791
+ """The number of different wallets holding the token."""
10792
+ holders: Int
10793
+ """The average age of the wallets that traded in the last 24h"""
10794
+ walletAgeAvg: String
10795
+ """The standard deviation of age of the wallets that traded in the last 24h"""
10796
+ walletAgeStd: String
10797
+ """The percentage of wallets that are less than 1d old that have traded in the last 24h"""
10798
+ swapPct1dOldWallet: String
10799
+ """The percentage of wallets that are less than 7d old that have traded in the last 24h"""
10800
+ swapPct7dOldWallet: String
10801
+ """The number of wallets that have sniped the token. Null for a token `tokenWalletStats` does not cover."""
10802
+ sniperCount: Int
10803
+ """The percentage of tokens held by snipers. Null for a token `tokenWalletStats` does not cover."""
10804
+ sniperHeldPercentage: Float
10805
+ """The number of wallets that have bundled the token. Null for a token `tokenWalletStats` does not cover."""
10806
+ bundlerCount: Int
10807
+ """The percentage of tokens held by bundlers. Null for a token `tokenWalletStats` does not cover."""
10808
+ bundlerHeldPercentage: Float
10809
+ """The number of wallets that have been an insider of the token. Null for a token `tokenWalletStats` does not cover."""
10810
+ insiderCount: Int
10811
+ """The percentage of tokens held by insiders. Null for a token `tokenWalletStats` does not cover."""
10812
+ insiderHeldPercentage: Float
10813
+ """The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders). Null for a token `tokenWalletStats` does not cover."""
10814
+ suspiciousCount: Int
10815
+ """The percentage of tokens held by suspicious wallets. Null for a token `tokenWalletStats` does not cover."""
10816
+ suspiciousHeldPercentage: Float
10817
+ """The percentage of tokens held by the dev. Null for a token `tokenWalletStats` does not cover."""
10818
+ devHeldPercentage: Float
10819
+ """The percentage of total supply held by the top 10 holders."""
10820
+ top10HoldersPercent: Float
10821
+ """The reasons the token has been flagged as a potential scam."""
10822
+ potentialScamReasons: [PotentialScamReason]
10823
+ """The all-time high price in USD."""
10824
+ athPrice: String
10825
+ """The unix timestamp when the all-time high price was reached."""
10826
+ athPriceTimestamp: Int
10827
+ """The all-time low price in USD."""
10828
+ atlPrice: String
10829
+ """The unix timestamp when the all-time low price was reached."""
10830
+ atlPriceTimestamp: Int
10831
+ """The all-time high fully diluted market cap."""
10832
+ athFdv: String
10833
+ """The unix timestamp when the all-time high FDV was reached."""
10834
+ athFdvTimestamp: Int
10835
+ """The all-time low fully diluted market cap."""
10836
+ atlFdv: String
10837
+ """The unix timestamp when the all-time low FDV was reached."""
10838
+ atlFdvTimestamp: Int
10839
+ """The all-time high circulating market cap."""
10840
+ athCircMc: String
10841
+ """The unix timestamp when the all-time high circulating market cap was reached."""
10842
+ athCircMcTimestamp: Int
10843
+ """The all-time low circulating market cap."""
10844
+ atlCircMc: String
10845
+ """The unix timestamp when the all-time low circulating market cap was reached."""
10846
+ atlCircMcTimestamp: Int
10847
+ }
10848
+
10849
+ """Metadata for a contract."""
10850
+ union EnhancedContract = EnhancedToken | EnhancedNftContract
10765
10851
 
10766
- """Integer equals condition."""
10767
- type IntEqualsCondition {
10768
- """The integer to equal."""
10769
- eq: Int!
10852
+ """Community gathered proposals for an asset."""
10853
+ type CommunityNote {
10854
+ """The contract address of the contract."""
10855
+ address: String!
10856
+ contractType: ContractType!
10857
+ currentContract: EnhancedContract
10858
+ """The contract after the community note was applied."""
10859
+ currentData: JSON
10860
+ """The ID of the contract (`address:id`)."""
10861
+ id: String!
10862
+ """The unix timestamp of when the community note was moderated."""
10863
+ moderatedAt: Int
10864
+ """The network ID the contract is deployed on."""
10865
+ networkId: Int!
10866
+ """The contract before the community note was applied."""
10867
+ previousData: JSON
10868
+ """The data of the community note."""
10869
+ proposalData: JSON!
10870
+ """The ordinal number of the community note."""
10871
+ proposalNum: Int!
10872
+ """The type of the community note."""
10873
+ proposalType: CommunityNoteType!
10874
+ """The unix timestamp of when the community note was created."""
10875
+ proposedAt: Int!
10876
+ """The status of the community note."""
10877
+ status: ContractProposalStatus!
10878
+ sortKey: String!
10770
10879
  }
10771
10880
 
10772
- """A network supported on Defined."""
10773
- type Network {
10774
- """The name of the network. For example, `arbitrum`."""
10775
- name: String!
10776
- """The network ID. For example, `42161` for `arbitrum`."""
10777
- id: Int!
10778
- networkShortName: String
10881
+ """Metadata for a decentralized exchange."""
10882
+ type Exchange {
10883
+ """The ID of the exchange (`address:id`)."""
10884
+ id: String!
10885
+ """The contract address of the exchange."""
10886
+ address: String!
10887
+ """The hex string for the exchange color."""
10888
+ color: String
10889
+ """The name of the exchange."""
10890
+ name: String
10891
+ """The version of the exchange, if applicable."""
10892
+ exchangeVersion: String
10893
+ """The exchange logo URL."""
10894
+ iconUrl: String
10895
+ """The network ID the exchange is deployed on."""
10896
+ networkId: Int!
10897
+ """The URL for the exchange."""
10898
+ tradeUrl: String
10779
10899
  }
10780
10900
 
10781
- """The status for a network supported on Defined."""
10782
- type MetadataResponse {
10783
- """The last processed block on the network."""
10784
- lastProcessedBlock: Int
10785
- """The unix timestamp for the last processed block on the network."""
10786
- lastProcessedTimestamp: Int
10787
- """The network ID."""
10788
- networkId: Int!
10789
- """The name of the network."""
10790
- networkName: String!
10791
- """Transactions per second, averaged over the network's latest indexed blocks (up to 500 blocks from the past 5 minutes). Refreshed every 5 minutes. Null when fewer than two blocks were indexed in that window. On Solana-based networks it counts every executed transaction, including failed and vote transactions."""
10792
- transactionsPerSecond: Float
10901
+ """Filters for community notes."""
10902
+ input CommunityNotesFilter {
10903
+ """The contract address of the contract."""
10904
+ address: String
10905
+ contractType: ContractType
10906
+ """The network ID the contract is deployed on."""
10907
+ networkId: [Int]
10908
+ """The type of the proposal."""
10909
+ proposalType: CommunityNoteType
10793
10910
  }
10794
10911
 
10795
- input BlocksInput {
10796
- networkId: Int!
10797
- blockNumbers: [Int!]
10798
- timestamps: [Int!]
10912
+ """Input type of `getCommunityNotes`."""
10913
+ input CommunityNotesInput {
10914
+ """A set of filters to apply"""
10915
+ filter: CommunityNotesFilter
10916
+ """The maximum number of community notes to return."""
10917
+ limit: Int
10918
+ """The cursor to use for pagination."""
10919
+ cursor: String
10799
10920
  }
10800
10921
 
10801
- type Block {
10802
- blockNumber: Int!
10803
- timestamp: Int!
10804
- hash: String!
10922
+ """Community notes data."""
10923
+ type CommunityNotesResponse {
10924
+ """The list of community notes matching the filter parameters."""
10925
+ items: [CommunityNote!]!
10926
+ """The number of community notes returned."""
10927
+ count: Int!
10928
+ """A cursor for use in pagination."""
10929
+ cursor: String
10805
10930
  }
10806
10931
 
10807
- """A wallet matching a filter."""
10808
- type WalletFilterResult {
10809
- """The wallet address"""
10810
- address: String!
10811
- """The network ID of the wallet (only present if filtered by network)"""
10812
- networkId: Int
10813
- """The unix timestamp for the first transaction from this wallet"""
10814
- firstTransactionAt: Int
10815
- """The unix timestamp for the last transaction from this wallet"""
10816
- lastTransactionAt: Int!
10817
- """The labels associated with the wallet"""
10818
- labels: [String!]!
10819
- """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)."""
10820
- identityLabels: [String!]
10821
- """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."""
10822
- tradeSourceIds: [String!]
10823
- """Volume in USD in the past day"""
10824
- volumeUsd1d: String!
10825
- """Total volume in USD in the past day including all tokens"""
10826
- volumeUsdAll1d: String!
10827
- """Realized profit in USD in the past day"""
10828
- realizedProfitUsd1d: String!
10829
- """Realized profit in USD excluding native tokens in the past day. Tracking began July 2, 2026; null for index records written before then."""
10830
- realizedProfitUsdExNative1d: String
10831
- """Average profit in USD per trade in the past day"""
10832
- averageProfitUsdPerTrade1d: String!
10833
- """Average swap amount in USD in the past day"""
10834
- averageSwapAmountUsd1d: String!
10835
- """Realized profit percentage in the past day"""
10836
- realizedProfitPercentage1d: Float!
10837
- """Realized profit percentage excluding native tokens in the past day. Tracking began July 2, 2026; null for index records written before then."""
10838
- realizedProfitPercentageExNative1d: Float
10839
- """Average hold period, in seconds, for positions sold during the past day. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold."""
10840
- avgHoldPeriodSec1d: Float
10841
- """Number of swaps in the past day"""
10842
- swaps1d: Int!
10843
- """Total number of swaps in the past day including all tokens"""
10844
- swapsAll1d: Int!
10845
- """Number of unique tokens traded in the past day"""
10846
- uniqueTokens1d: Int!
10847
- """Win rate in the past day"""
10848
- winRate1d: Float!
10849
- """Volume in USD in the past week"""
10850
- volumeUsd1w: String!
10851
- """Total volume in USD in the past week including all tokens"""
10852
- volumeUsdAll1w: String!
10853
- """Realized profit in USD in the past week"""
10854
- realizedProfitUsd1w: String!
10855
- """Realized profit in USD excluding native tokens in the past week. Tracking began July 2, 2026; null for index records written before then."""
10856
- realizedProfitUsdExNative1w: String
10857
- """Average profit in USD per trade in the past week"""
10858
- averageProfitUsdPerTrade1w: String!
10859
- """Average swap amount in USD in the past week"""
10860
- averageSwapAmountUsd1w: String!
10861
- """Realized profit percentage in the past week"""
10862
- realizedProfitPercentage1w: Float!
10863
- """Realized profit percentage excluding native tokens in the past week. Tracking began July 2, 2026; null for index records written before then."""
10864
- realizedProfitPercentageExNative1w: Float
10865
- """Average hold period, in seconds, for positions sold during the past week. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold."""
10866
- avgHoldPeriodSec1w: Float
10867
- """Number of swaps in the past week"""
10868
- swaps1w: Int!
10869
- """Total number of swaps in the past week including all tokens"""
10870
- swapsAll1w: Int!
10871
- """Number of unique tokens traded in the past week"""
10872
- uniqueTokens1w: Int!
10873
- """Win rate in the past week"""
10874
- winRate1w: Float!
10875
- """Volume in USD in the past 30 days"""
10876
- volumeUsd30d: String!
10877
- """Total volume in USD in the past 30 days including all tokens"""
10878
- volumeUsdAll30d: String!
10879
- """Realized profit in USD in the past 30 days"""
10880
- realizedProfitUsd30d: String!
10881
- """Realized profit in USD excluding native tokens in the past 30 days. Tracking began July 2, 2026; null for index records written before then."""
10882
- realizedProfitUsdExNative30d: String
10883
- """Average profit in USD per trade in the past 30 days"""
10884
- averageProfitUsdPerTrade30d: String!
10885
- """Average swap amount in USD in the past 30 days"""
10886
- averageSwapAmountUsd30d: String!
10887
- """Realized profit percentage in the past 30 days"""
10888
- realizedProfitPercentage30d: Float!
10889
- """Realized profit percentage excluding native tokens in the past 30 days. Tracking began July 2, 2026; null for index records written before then."""
10890
- realizedProfitPercentageExNative30d: Float
10891
- """Average hold period, in seconds, for positions sold during the past 30 days. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold."""
10892
- avgHoldPeriodSec30d: Float
10893
- """Number of swaps in the past 30 days"""
10894
- swaps30d: Int!
10895
- """Total number of swaps in the past 30 days including all tokens"""
10896
- swapsAll30d: Int!
10897
- """Number of unique tokens traded in the past 30 days"""
10898
- uniqueTokens30d: Int!
10899
- """Win rate in the past 30 days"""
10900
- winRate30d: Float!
10901
- """Volume in USD in the past year"""
10902
- volumeUsd1y: String!
10903
- """Total volume in USD in the past year including all tokens"""
10904
- volumeUsdAll1y: String!
10905
- """Realized profit in USD in the past year"""
10906
- realizedProfitUsd1y: String!
10907
- """Average profit in USD per trade in the past year"""
10908
- averageProfitUsdPerTrade1y: String!
10909
- """Average swap amount in USD in the past year"""
10910
- averageSwapAmountUsd1y: String!
10911
- """Realized profit percentage in the past year"""
10912
- realizedProfitPercentage1y: Float!
10913
- """Average hold period, in seconds, for positions sold during the past year. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold."""
10914
- avgHoldPeriodSec1y: Float
10915
- """Number of swaps in the past year"""
10916
- swaps1y: Int!
10917
- """Total number of swaps in the past year including all tokens"""
10918
- swapsAll1y: Int!
10919
- """Number of unique tokens traded in the past year"""
10920
- uniqueTokens1y: Int! @deprecated(reason: "uniqueTokens1y is no longer available as a distinct 1-year value; it now reflects the 30-day value (uniqueTokens30d).")
10921
- """Win rate in the past year"""
10922
- winRate1y: Float!
10923
- """The scammer score for the wallet."""
10924
- scammerScore: Int
10925
- """The bot score for the wallet."""
10926
- botScore: Int
10927
- """Total number of tokens created by this wallet across all networks."""
10928
- tokensCreatedCount: Int
10929
- """Total number of launchpad tokens migrated (graduated) by this wallet across all networks."""
10930
- tokensMigratedCount: Int
10931
- """Wallet behavior classification. Null is equivalent to NORMIE."""
10932
- category: WalletCategory
10933
- """The native token balance of the wallet (only present if filtered by network)"""
10934
- nativeTokenBalance: String
10935
- """The backfill state of the wallet."""
10936
- backfillState: WalletAggregateBackfillState
10937
- """The wallet identity and profile data"""
10938
- wallet: Wallet
10932
+ """Metadata for a wallet label from the WALLET_LABEL_TYPES vocabulary"""
10933
+ type WalletLabelType {
10934
+ """Label name (e.g. WHALE, CEX, KOL)"""
10935
+ name: String!
10936
+ """Human-readable display name"""
10937
+ displayName: String!
10938
+ """Description of what this label means"""
10939
+ description: String!
10939
10940
  }
10940
10941
 
10941
10942
  enum SparklineAttribute {
@@ -11156,6 +11157,16 @@ enum NetworkRankingAttribute {
11156
11157
  swaps4
11157
11158
  swaps12
11158
11159
  swaps24
11160
+ chainTransactions5m
11161
+ chainTransactions1
11162
+ chainTransactions4
11163
+ chainTransactions12
11164
+ chainTransactions24
11165
+ trades5m
11166
+ trades1
11167
+ trades4
11168
+ trades12
11169
+ trades24
11159
11170
  }
11160
11171
 
11161
11172
  """The attribute used to rank launchpads. Rankings apply to the combined stats by default; set `phase` on the ranking to rank by `pre` or `post` phase stats instead (stats attributes only)."""
@@ -12293,6 +12304,26 @@ type NetworkFilterResult {
12293
12304
  swaps12: Int
12294
12305
  """The number of DEX swaps in the past 24 hours. A trade routed through two pools counts as two swaps."""
12295
12306
  swaps24: Int
12307
+ """The number of transactions on the chain in the past 5 minutes, failed ones included. Null until the network has been counted for the whole window."""
12308
+ chainTransactions5m: Int
12309
+ """The number of transactions on the chain in the past hour, failed ones included. Null until the network has been counted for the whole window."""
12310
+ chainTransactions1: Int
12311
+ """The number of transactions on the chain in the past 4 hours, failed ones included. Null until the network has been counted for the whole window."""
12312
+ chainTransactions4: Int
12313
+ """The number of transactions on the chain in the past 12 hours, failed ones included. Null until the network has been counted for the whole window."""
12314
+ chainTransactions12: Int
12315
+ """The number of transactions on the chain in the past 24 hours, failed ones included. Null until the network has been counted for the whole window."""
12316
+ chainTransactions24: Int
12317
+ """The number of DEX trades on the network in the past 5 minutes. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps. Null if the trades couldn't be counted."""
12318
+ trades5m: Int
12319
+ """The number of DEX trades on the network in the past hour. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps. Null if the trades couldn't be counted."""
12320
+ trades1: Int
12321
+ """The number of DEX trades on the network in the past 4 hours. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps. Null if the trades couldn't be counted."""
12322
+ trades4: Int
12323
+ """The number of DEX trades on the network in the past 12 hours. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps. Null if the trades couldn't be counted."""
12324
+ trades12: Int
12325
+ """The number of DEX trades on the network in the past 24 hours. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps. Null if the trades couldn't be counted."""
12326
+ trades24: Int
12296
12327
  }
12297
12328
 
12298
12329
  """Response returned by `filterNetworks`."""
@@ -13059,6 +13090,7 @@ enum TokenSocialLink {
13059
13090
  REDDIT
13060
13091
  SLACK
13061
13092
  TELEGRAM
13093
+ TIKTOK
13062
13094
  TWITCH
13063
13095
  TWITTER
13064
13096
  WEBSITE
@@ -14073,6 +14105,26 @@ input NetworkFilters {
14073
14105
  swaps12: NumberFilter
14074
14106
  """The number of DEX swaps in the past 24 hours. A trade routed through two pools counts as two swaps."""
14075
14107
  swaps24: NumberFilter
14108
+ """The number of transactions on the chain in the past 5 minutes, failed ones included."""
14109
+ chainTransactions5m: NumberFilter
14110
+ """The number of transactions on the chain in the past hour, failed ones included."""
14111
+ chainTransactions1: NumberFilter
14112
+ """The number of transactions on the chain in the past 4 hours, failed ones included."""
14113
+ chainTransactions4: NumberFilter
14114
+ """The number of transactions on the chain in the past 12 hours, failed ones included."""
14115
+ chainTransactions12: NumberFilter
14116
+ """The number of transactions on the chain in the past 24 hours, failed ones included."""
14117
+ chainTransactions24: NumberFilter
14118
+ """The number of DEX trades on the network in the past 5 minutes. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps."""
14119
+ trades5m: NumberFilter
14120
+ """The number of DEX trades on the network in the past hour. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps."""
14121
+ trades1: NumberFilter
14122
+ """The number of DEX trades on the network in the past 4 hours. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps."""
14123
+ trades4: NumberFilter
14124
+ """The number of DEX trades on the network in the past 12 hours. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps."""
14125
+ trades12: NumberFilter
14126
+ """The number of DEX trades on the network in the past 24 hours. A trade routed through several pools counts once, and no trade is filtered out, unlike swaps."""
14127
+ trades24: NumberFilter
14076
14128
  }
14077
14129
 
14078
14130
  """Phase-level stats filters for `filterLaunchpads`. Each field is a numeric range filter applied to one phase's stats."""
@@ -15704,6 +15756,8 @@ enum WalletLabel {
15704
15756
  SANCTIONED
15705
15757
  """Wallet behind token scams: a serial rug deployer, its launch crew, or a honeypot creator. Its confidence is `scammerScore`."""
15706
15758
  SCAMMER
15759
+ """Wallet has launched 20 or more tokens on launchpads. It says nothing about whether they were scams: a wallet behind scam launches is `SCAMMER`."""
15760
+ SERIAL_DEPLOYER
15707
15761
  """Skilled trader with $5k+ net profit over a year and a record chance rarely produces. Recomputed weekly on Solana, Robinhood, Ethereum, BSC and Base."""
15708
15762
  SMART_TRADER
15709
15763
  """Wallet has made over $7.5K profit in the last 90 days trading tokens that are older than 2 days."""