@codex-data/sdk 2.5.5 → 2.5.8

package/package.json

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

package/schema.graphql

@@ -7967,6 +7967,10 @@ type PredictionTrade {
   networkId: Int
   """The exchange contract address."""
   exchangeAddress: String
+  """The exchange contract the trade executed on. Differs from `exchangeAddress` when a Polymarket market migrated to a newer exchange."""
+  exchangeTradedOnAddress: String
+  """The contract address of the collateral token the trade settled in."""
+  collateralTokenAddress: String
   """The transaction id."""
   transactionId: String
   """The prediction market."""
@@ -11505,6 +11509,16 @@ type ExplorerTokenData {
   tokenType: String
 }
 
+"""Where a launchpad token's creator fees go."""
+enum FeeMode {
+  """Creator fees go to the token's creator."""
+  CREATOR_FEE
+  """Creator fees are paid back to traders as cashback."""
+  CASHBACK
+  """Creator fees are paid to the token's holders."""
+  HOLDER_REWARDS
+}
+
 type LaunchpadData {
   """The name of the launchpad."""
   name: String @deprecated(reason: "Use launchpadName instead")
@@ -11533,7 +11547,13 @@ type LaunchpadData {
   """The icon URL of the launchpad."""
   launchpadIconUrl: String
   """Whether cashback is enabled for this launchpad token (Pump V1/V2 only)."""
-  isCashbackEnabled: Boolean
+  isCashbackEnabled: Boolean @deprecated(reason: "Use feeModes instead; CASHBACK is in feeModes when cashback is enabled")
+  """Where this launchpad token's creator fees go (Pump and PumpAmm only). Pump tokens have exactly one mode. Not set for Pump tokens whose curve predates the cashback fields."""
+  feeModes: [FeeMode!]
+  """The holder-reward fee rate in basis points. Null when the launchpad's default fee schedule applies. Read when the token's metadata was fetched; may be stale if the creator can edit the fee."""
+  holderRewardFeeBps: Int
+  """The mint of the token holder rewards are paid in."""
+  holderRewardQuoteMint: String
   """The token category assigned by the launchpad. Populated by launchpads that publish a category taxonomy (e.g. Scale/Creator, Eitherway). Values include platform, meme, utility, etc."""
   category: String
 }
@@ -12744,9 +12764,9 @@ type PairFilterResult {
   riskCoverage: RiskAnalysisCoverage
   """The reason codes behind `riskVerdict`, unordered. New codes are added over time, so do not assume this list is exhaustive."""
   riskReasons: [RiskReasonCode!]
-  """Buy tax of the pair's token of interest, measured by the latest decisive contract analysis, as a fraction (0.05 means 5%). Null when no decisive analysis measured it."""
+  """Buy tax of the pair's token of interest, measured on a simulated buy alone by the latest decisive contract analysis, as a fraction (0.05 means 5%). Pool, hook and launchpad platform fees are not included. Null when no decisive analysis could measure the buy on its own."""
   riskBuyTax: Float
-  """Sell tax of the pair's token of interest, measured by the latest decisive contract analysis, as a fraction (0.05 means 5%). Null when no decisive analysis measured it, including when that analysis found a honeypot: its test sale failed, so no sell tax was measured."""
+  """Sell tax of the pair's token of interest, measured on a simulated sell alone by the latest decisive contract analysis, as a fraction (0.05 means 5%). Pool, hook and launchpad platform fees are not included. Null when no decisive analysis could measure the sell on its own, including when that analysis found a honeypot: its test sale failed, so no sell tax was measured."""
   riskSellTax: Float
 }
 
@@ -13191,6 +13211,8 @@ input TokenFilters {
   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, c8ntinuum Pledge, c8ntinuum Launchpad."""
   launchpadName: [String!]
+  """A list of launchpad fee modes. Matches tokens whose fee modes include any of them (Pump and PumpAmm only)."""
+  feeModes: [FeeMode!]
   """Indicates if the launchpad is completed."""
   launchpadCompleted: Boolean
   """Indicates if the launchpad has migrated."""
@@ -13460,9 +13482,9 @@ type TokenRisk {
   coverage: RiskAnalysisCoverage
   """The reason codes behind the verdict, unordered. Empty when nothing fired; null when unassessed. New codes are added over time, so do not assume this list is exhaustive or that a familiar set is the whole picture."""
   reasons: [RiskReasonCode!]
-  """Buy tax measured by the latest decisive contract analysis, as a fraction (0.05 means 5%). Can be newer than `verdict`, which updates on the next assessment. Null when no decisive analysis measured it."""
+  """Buy tax measured on a simulated buy alone by the latest decisive contract analysis, as a fraction (0.05 means 5%). Pool, hook and launchpad platform fees are not included. Can be newer than `verdict`, which updates on the next assessment. Null when no decisive analysis could measure the buy on its own."""
   buyTax: Float
-  """Sell tax measured by the latest decisive contract analysis, as a fraction (0.05 means 5%). Can be newer than `verdict`, which updates on the next assessment. Null when no decisive analysis measured it, including when that analysis found a honeypot: its test sale failed, so no sell tax was measured."""
+  """Sell tax measured on a simulated sell alone by the latest decisive contract analysis, as a fraction (0.05 means 5%). Pool, hook and launchpad platform fees are not included. Can be newer than `verdict`, which updates on the next assessment. Null when no decisive analysis could measure the sell on its own, including when that analysis found a honeypot: its test sale failed, so no sell tax was measured."""
   sellTax: Float
 }
 
@@ -13499,9 +13521,9 @@ enum RiskReasonCode {
   PROOF_HONEYPOT_SIM
   PROOF_NON_TRANSFERABLE
   PROOF_TRANSFER_FEE_100
-  PROOF_PAUSED
+  PROOF_PAUSED @deprecated(reason: "Never emitted. An engaged pause is reported as TAX_PAUSED, a scored reason rather than proof, because a pause can be lifted. Use TAX_PAUSED instead.")
   PROOF_DEFAULT_FROZEN
-  PROOF_RUG_OCCURRED
+  PROOF_RUG_OCCURRED @deprecated(reason: "Never emitted. A rug never forces SCAM. It will be reported as LIQ_RUG_OCCURRED, an informational liquidity reason that adds no points.")
   PROOF_POOL_TRAP_SIM
   AUTH_MINT
   AUTH_FREEZE
@@ -13539,6 +13561,7 @@ enum RiskReasonCode {
   REP_SCAMMER_FUNDED
   REP_IMITATOR_SYMBOL
   REP_IMITATOR_NAME
+  REP_IMITATOR_IMAGE
   LABEL_MANUAL_SCAM
   LABEL_VERIFIED
 }
@@ -14889,7 +14912,7 @@ type SimulateTransferErrorsType {
 type SimulateSwapType {
   """Buy outcome inferred from recorded errors. Do not use this flag alone: pending or incomplete records may have no errors. Inspect verdict and status."""
   buySuccess: Boolean
-  """Current analyzer: buy tax as a decimal fraction encoded as a string (0.05 means 5%). Legacy simulation rows used percentage values and a different sign convention; values are returned without normalization. Null when unavailable."""
+  """Current analyzer: tax on the simulated buy alone, excluding pool fees, as a decimal fraction encoded as a string (0.05 means 5%). Legacy simulation rows used percentage values and a different sign convention; values are returned without normalization. Null when the buy could not be measured on its own."""
   buyTax: String
   """Gas units consumed by the simulated buy, encoded as an integer string. Null when not recorded."""
   buyGasUsed: String
@@ -14897,7 +14920,7 @@ type SimulateSwapType {
   maxBuyAmount: String
   """Sell outcome inferred from recorded errors. Do not use this flag alone: pending or incomplete records may have no errors. Inspect verdict and status."""
   sellSuccess: Boolean
-  """Current analyzer: sell tax as a decimal fraction encoded as a string (0.05 means 5%). Legacy simulation rows used percentage values and a different sign convention; values are returned without normalization. Null when unavailable."""
+  """Current analyzer: tax on the simulated sell alone, excluding pool fees, as a decimal fraction encoded as a string (0.05 means 5%). Null when the sell could not be measured on its own, or when the sale failed by reverting or returning almost nothing; a sell cap stores the tax measured on the smaller sale that went through. Older records can instead hold an estimate from the whole buy-and-sell round trip, or `1` for a failed sell; `TokenRisk.sellTax` returns measured values only. Legacy simulation rows used percentage values and a different sign convention; values are returned without normalization."""
   sellTax: String
   """Gas units consumed by the simulated sell, encoded as an integer string. Null when not recorded."""
   sellGasUsed: String
@@ -17819,3 +17842,106 @@ type Event {
   currencyUnits: CurrencyUnits
 }
 
+type TokenFilterEventWebhookCondition {
+  """Seconds a token must wait after it stops matching before it can fire again."""
+  cooldownSeconds: Int!
+  """The token contract address. Requires exactly one `networkId`."""
+  tokenAddress: StringEqualsCondition
+  """The network IDs to listen on."""
+  networkId: OneOfNumberCondition
+  """Include tokens flagged as scams. Scams are excluded by default."""
+  includeScams: Boolean
+  """Match only tokens whose potential scam flag equals this value."""
+  potentialScam: Boolean
+  """The token creator's wallet address."""
+  creatorAddress: StringEqualsCondition
+  """The launchpad names to match, case-insensitive."""
+  launchpadName: OneOfStringCondition
+  """Match only tokens whose launchpad completion equals this value."""
+  launchpadCompleted: Boolean
+  """Match only tokens whose launchpad migration equals this value."""
+  launchpadMigrated: Boolean
+  """The launchpad graduation percent."""
+  launchpadGraduationPercent: ComparisonOperator
+  """The price in USD."""
+  priceUsd: ComparisonOperator
+  """The liquidity in USD."""
+  liquidityUsd: ComparisonOperator
+  """The fully diluted market cap in USD."""
+  fdvMarketCapUsd: ComparisonOperator
+  """The circulating market cap in USD."""
+  circulatingMarketCapUsd: ComparisonOperator
+  """The number of holders."""
+  holders: ComparisonOperator
+  """Seconds since the token's first pair was created."""
+  ageSeconds: ComparisonOperator
+  """The number of sniper wallets."""
+  sniperCount: ComparisonOperator
+  """The percentage of supply held by snipers."""
+  sniperHeldPercentage: ComparisonOperator
+  """The number of bundler wallets."""
+  bundlerCount: ComparisonOperator
+  """The percentage of supply held by bundlers."""
+  bundlerHeldPercentage: ComparisonOperator
+  """The number of insider wallets."""
+  insiderCount: ComparisonOperator
+  """The percentage of supply held by insiders."""
+  insiderHeldPercentage: ComparisonOperator
+  """The percentage of supply held by the developer."""
+  devHeldPercentage: ComparisonOperator
+  """The percentage of supply held by the top 10 holders."""
+  top10HoldersPercent: ComparisonOperator
+  """Conditions for the 5-minute window."""
+  min5: WindowedTokenFilterEventWebhookCondition
+  """Conditions for the 1-hour window."""
+  hour1: WindowedTokenFilterEventWebhookCondition
+  """Conditions for the 4-hour window."""
+  hour4: WindowedTokenFilterEventWebhookCondition
+  """Conditions for the 12-hour window."""
+  hour12: WindowedTokenFilterEventWebhookCondition
+  """Conditions for the 1-day window."""
+  day1: WindowedTokenFilterEventWebhookCondition
+}
+
+type WindowedTokenFilterEventWebhookCondition {
+  """The price change over the window, as a fraction: 0.25 is 25%."""
+  priceChange: TokenFilterEventChangeCondition
+  """The volume change against the previous window, as a fraction."""
+  volumeChange: TokenFilterEventChangeCondition
+  """The volume in USD."""
+  volumeUsd: ComparisonOperator
+  """The buy volume in USD."""
+  buyVolumeUsd: ComparisonOperator
+  """The sell volume in USD."""
+  sellVolumeUsd: ComparisonOperator
+  """The number of buys."""
+  buys: ComparisonOperator
+  """The number of sells."""
+  sells: ComparisonOperator
+  """The number of transactions."""
+  transactions: ComparisonOperator
+  """The number of unique buyers."""
+  uniqueBuys: ComparisonOperator
+  """The number of unique sellers."""
+  uniqueSells: ComparisonOperator
+  """The number of unique traders."""
+  uniqueTransactions: ComparisonOperator
+  """The trending score."""
+  trendingScore: ComparisonOperator
+}
+
+type TokenFilterEventChangeCondition {
+  """Greater than."""
+  gt: String
+  """Greater than or equal to."""
+  gte: String
+  """Less than."""
+  lt: String
+  """Less than or equal to."""
+  lte: String
+  """Equal to."""
+  eq: String
+  """Compare the size of the change, ignoring whether it went up or down."""
+  absolute: Boolean
+}
+