@codex-data/sdk 2.4.8 → 2.4.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codex-data/sdk",
-  "version": "2.4.8",
+  "version": "2.4.12",
   "engines": {
     "node": ">=17.5.0"
   },

package/schema.graphql

@@ -603,7 +603,7 @@ type Query {
   filterLaunchpads(
     """A set of filters to apply."""
     filters: LaunchpadFilters
-    """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm."""
+    """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm, Continuum Pledge, Continuum Launchpad."""
     launchpads: [String!]
     """A list of network IDs to include. If not provided, all networks are considered."""
     networks: [Int!]
@@ -807,6 +807,11 @@ type Query {
     """A list of token ID input."""
     ids: [TokenInput!]
   ): [EnhancedToken]!
+  """Returns pairs by their IDs (`address:networkId`, or `poolId:networkId` for singleton pools such as Uniswap V4), in request order, with `null` for an ID that is not a known pair. Unlike `filterPairs(pairs:)`, a token address is never expanded into its top pairs. At most 200 IDs."""
+  pairs(
+    """A list of pair IDs (`address:networkId`)."""
+    ids: [String!]!
+  ): [Pair]!
   """Returns metadata for a pair of tokens."""
   pairMetadata(
     """The ID of the pair (`address:networkId`)."""
@@ -1181,9 +1186,13 @@ type Subscription {
     """The network ID to stream holder updates for every token on. Used only when `tokenId` is omitted."""
     networkId: Int
   ): HoldersUpdate
-  """Live-streamed balance updates for a given wallet."""
+  """Live-streamed balance updates for a given wallet. Updates left out by `networks` or `excludeTokens` are not charged."""
   onBalanceUpdated(
     walletAddress: String!
+    """Only send updates on these network IDs. Defaults to every network."""
+    networks: [Int!]
+    """Token addresses or IDs (`address:networkId`) to leave out. Use `native` for native balances, or `native:<networkId>` for one network's. Max 200."""
+    excludeTokens: [String!]
   ): Balance!
   """Live-streamed token lifecycle events (mints and burns)."""
   onTokenLifecycleEventsCreated(
@@ -3932,9 +3941,9 @@ input NftContractInput {
 
 """Input type of `EventQueryTimestamp`."""
 input EventQueryTimestampInput {
-  """The unix timestamp for the start of the requested range."""
+  """The unix timestamp for the start of the requested range (inclusive)."""
   from: Int!
-  """The unix timestamp for the end of the requested range."""
+  """The unix timestamp for the end of the requested range (inclusive). For `getTokenEvents`, `to` may equal `from` to select one second."""
   to: Int!
 }
 
@@ -9536,23 +9545,23 @@ type TokenFilterResult {
   swapPct1dOldWallet: String
   """The percentage of wallets that are less than 7d old that have traded in the last 24h"""
   swapPct7dOldWallet: String
-  """The number of wallets that have sniped the token"""
+  """The number of wallets that have sniped the token. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   sniperCount: Int
-  """The percentage of tokens held by snipers"""
+  """The percentage of tokens held by snipers. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   sniperHeldPercentage: Float
-  """The number of wallets that have bundled the token"""
+  """The number of wallets that have bundled the token. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   bundlerCount: Int
-  """The percentage of tokens held by bundlers"""
+  """The percentage of tokens held by bundlers. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   bundlerHeldPercentage: Float
-  """The number of wallets that have been an insider of the token"""
+  """The number of wallets that have been an insider of the token. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   insiderCount: Int
-  """The percentage of tokens held by insiders"""
+  """The percentage of tokens held by insiders. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   insiderHeldPercentage: Float
-  """The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders)"""
+  """The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders). Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   suspiciousCount: Int
-  """The percentage of tokens held by suspicious wallets"""
+  """The percentage of tokens held by suspicious wallets. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   suspiciousHeldPercentage: Float
-  """The percentage of tokens held by the dev"""
+  """The percentage of tokens held by the dev. Null for a token without a launchpad; `tokenWalletStats` serves EVM ones."""
   devHeldPercentage: Float
   """The percentage of total supply held by the top 10 holders."""
   top10HoldersPercent: Float
@@ -11290,6 +11299,8 @@ input EventsQueryInput {
   symbolType: SymbolType
   """When `true`, return the token's latest events across ALL of its pools instead of only its top pool. Requires `symbolType: TOKEN`, rejects `quoteToken`, and issues cursors that are not interchangeable with top-pool cursors. Slower. Available on the DEFINED plan only. Defaults to `false`."""
   crossPools: Boolean
+  """Only return events from this transaction (exact match; EVM hashes are matched case-insensitively). Applied inside the pair and time range scan, so pass the block timestamp as `timestamp { from, to }` (an equal `from` and `to` is inclusive) to keep the scan small."""
+  transactionHash: String
 }
 
 input MakerEventsQueryInput {
@@ -13154,7 +13165,7 @@ input TokenFilters {
   creatorAddresses: [String!]
   """A list of launchpad protocols."""
   launchpadProtocol: [String!]
-  """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm."""
+  """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm, Continuum Pledge, Continuum Launchpad."""
   launchpadName: [String!]
   """Indicates if the launchpad is completed."""
   launchpadCompleted: Boolean
@@ -13194,23 +13205,23 @@ input TokenFilters {
   poolFees24: NumberFilter
   """Filter by fee to volume ratio in the past 24 hours."""
   feeToVolumeRatio24: NumberFilter
-  """Filter by number of wallets that have sniped the token"""
+  """Filter by number of wallets that have sniped the token. Covers launchpad tokens only; any other token never matches."""
   sniperCount: NumberFilter
-  """Filter by percentage of tokens held by snipers"""
+  """Filter by percentage of tokens held by snipers. Covers launchpad tokens only; any other token never matches."""
   sniperHeldPercentage: NumberFilter
-  """Filter by number of wallets that have bundled the token"""
+  """Filter by number of wallets that have bundled the token. Covers launchpad tokens only; any other token never matches."""
   bundlerCount: NumberFilter
-  """Filter by percentage of tokens held by bundlers"""
+  """Filter by percentage of tokens held by bundlers. Covers launchpad tokens only; any other token never matches."""
   bundlerHeldPercentage: NumberFilter
-  """Filter by number of wallets that have been an insider of the token"""
+  """Filter by number of wallets that have been an insider of the token. Covers launchpad tokens only; any other token never matches."""
   insiderCount: NumberFilter
-  """Filter by percentage of tokens held by insiders"""
+  """Filter by percentage of tokens held by insiders. Covers launchpad tokens only; any other token never matches."""
   insiderHeldPercentage: NumberFilter
-  """Filter by number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders)"""
+  """Filter by number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders). Covers launchpad tokens only; any other token never matches."""
   suspiciousCount: NumberFilter
-  """Filter by percentage of tokens held by suspicious wallets"""
+  """Filter by percentage of tokens held by suspicious wallets. Covers launchpad tokens only; any other token never matches."""
   suspiciousHeldPercentage: NumberFilter
-  """Filter by percentage of tokens held by the dev"""
+  """Filter by percentage of tokens held by the dev. Covers launchpad tokens only; any other token never matches."""
   devHeldPercentage: NumberFilter
   """Filter by top 10 holders percentage."""
   top10HoldersPercent: NumberFilter
@@ -15283,9 +15294,9 @@ input OnLaunchpadTokenEventInput {
   protocol: LaunchpadTokenProtocol
   """A list of launchpad protocols."""
   protocols: [LaunchpadTokenProtocol!]
-  """The name of the launchpad. One of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm."""
+  """The name of the launchpad. One of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm, Continuum Pledge, Continuum Launchpad."""
   launchpadName: String
-  """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm."""
+  """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm, Continuum Pledge, Continuum Launchpad."""
   launchpadNames: [String!]
   """The type of event."""
   eventType: LaunchpadTokenEventType
@@ -15504,9 +15515,9 @@ input OnLaunchpadTokenEventBatchInput {
   protocols: [LaunchpadTokenProtocol!]
   """The network ID that the token is deployed on."""
   networkId: Int
-  """The name of the launchpad. One of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm."""
+  """The name of the launchpad. One of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm, Continuum Pledge, Continuum Launchpad."""
   launchpadName: String
-  """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm."""
+  """A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift, meme.fun, Flywheel, Realm, Continuum Pledge, Continuum Launchpad."""
   launchpadNames: [String!]
   """The type of event."""
   eventType: LaunchpadTokenEventType
@@ -15536,6 +15547,8 @@ enum WalletLabel {
   CEX
   """Decentralized exchange wallet."""
   DEX
+  """Skilled trader with $25k+ net profit over a year, a record chance rarely produces, and a 60%+ win rate. Recomputed weekly on Solana, Robinhood, Ethereum, BSC and Base."""
+  ELITE_TRADER
   """Project founder wallet."""
   FOUNDER
   """Exploited a contract."""
@@ -15560,10 +15573,12 @@ enum WalletLabel {
   SANCTIONED
   """Wallet behind token scams: a serial rug deployer, its launch crew, or a honeypot creator. Its confidence is `scammerScore`."""
   SCAMMER
+  """Skilled trader with $5k+ net profit over a year and a record chance rarely produces. Recomputed weekly on Solana, Robinhood, Ethereum, BSC and Base."""
+  SMART_TRADER
   """Wallet has made over $7.5K profit in the last 90 days trading tokens that are older than 2 days."""
-  SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD
+  SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD @deprecated(reason: "Use ELITE_TRADER or SMART_TRADER, which test that the profit isn't luck. Still written while both run side by side; it will be removed.")
   """Wallet has made over $5K profit in the last 90 days trading tokens that are between 1 hour and 2 days old."""
-  SMART_TRADER_TOKENS_UNDER_TWO_DAYS_OLD
+  SMART_TRADER_TOKENS_UNDER_TWO_DAYS_OLD @deprecated(reason: "Use ELITE_TRADER or SMART_TRADER, which test that the profit isn't luck. Still written while both run side by side; it will be removed.")
   """Wallet has made over $3K profit in the last 90 days trading tokens that were launched within their first hour."""
   SNIPER
   """Venture capital fund."""
@@ -17317,7 +17332,7 @@ input TokenWalletStatsInput {
   networkId: Int!
 }
 
-"""The sniper, bundler and insider wallets that still hold a token. Counts, amounts and addresses cover current holders only: a labelled wallet that has sold its whole balance is left out, so every figure falls as those wallets sell. Available for launchpad tokens on every network, and for EVM tokens without a launchpad that have a known creator and were created since 2025-10-08. Other tokens return zeros."""
+"""The sniper, bundler and insider wallets that still hold a token. Counts, amounts and addresses cover current holders only: a labelled wallet that has sold its whole balance is left out, so every figure falls as those wallets sell. Each label reads at most 1,000 holders; past that, its count reads 1,000 and its amount and percentage cover those holders only. Available for launchpad tokens on every network, and for EVM tokens without a launchpad that have a known creator and were created since 2025-10-08. Read `covered` first: for any other token it is false, and every figure is 0 because nothing was measured."""
 type TokenWalletStats {
   """The ID of the token (`address:networkId`)."""
   tokenId: String!
@@ -17327,7 +17342,9 @@ type TokenWalletStats {
   networkId: Int!
   """The total supply of the token, unshifted. Every held percentage is measured against it."""
   tokenTotalSupply: String!
-  """The number of sniper wallets that hold this token. A sniper bought within the first 5 seconds of trading."""
+  """Whether Codex tracks snipers, bundlers and insiders for this token. When false, every count and percentage is 0 because nothing was measured, not because none were found."""
+  covered: Boolean!
+  """The number of sniper wallets that hold this token. A sniper bought within the first 5 seconds of trading. The creator's own buy at launch counts."""
   sniperCount: Int!
   """The percentage of token supply held by sniper wallets."""
   sniperHeldPercentage: Float!
@@ -17335,7 +17352,7 @@ type TokenWalletStats {
   sniperAddresses: [String!]!
   """The amount of the token held by sniper wallets, unshifted."""
   sniperHeldAmount: String!
-  """The number of bundler wallets that hold this token. A bundler is one of 4 or more wallets that bought the token in the same block at launch."""
+  """The number of bundler wallets that hold this token. A bundler is one of 4 or more wallets that bought the token in the same block while it was on its launchpad, or in its first hour when it has none. A wallet one sender bought a large share for, alongside other wallets in the same block, is a bundler too."""
   bundlerCount: Int!
   """The percentage of token supply held by bundler wallets."""
   bundlerHeldPercentage: Float!
@@ -17343,7 +17360,7 @@ type TokenWalletStats {
   bundlerAddresses: [String!]!
   """The amount of the token held by bundler wallets, unshifted."""
   bundlerHeldAmount: String!
-  """The number of insider wallets that hold this token. An insider received the token through a link to its creator rather than by buying it on the open market."""
+  """The number of insider wallets that hold this token. An insider got the token through a link to its creator rather than by buying it on the open market: it bought in the creation transaction, received the token from the creator, or was first funded by the creator. On Solana, a wallet seeded with the token in its first minutes without buying it is an insider too."""
   insiderCount: Int!
   """The percentage of token supply held by insider wallets."""
   insiderHeldPercentage: Float!