@codex-data/sdk 1.0.5 → 1.0.7

package/src/resources/schema.graphql

@@ -165,9 +165,12 @@ type Balance {
   """The ID of the token (`tokenAddress:networkId`)."""
   tokenId: String!
 
-  """The wallet address"""
+  """The wallet address."""
   address: String!
 
+  """The wallet network."""
+  networkId: Int!
+
   """The contract address of the token."""
   tokenAddress: String!
 
@@ -179,24 +182,38 @@ type Balance {
   """
   shiftedBalance: Float!
 
-  """The time that this address first held a token"""
+  """The time that this address first held a token."""
   firstHeldTimestamp: Int
 }
 
 input BalancesInput {
   """The ID of the wallet (`walletAddress:networkId`)."""
-  walletId: String!
+  walletId: String @deprecated(reason: "Use walletAddress and networkId instead")
+
+  """The wallet address to filter by."""
+  walletAddress: String
 
   """A cursor for use in pagination."""
   cursor: String
 
-  """Optional token specifically request the balance for"""
-  filterToken: String
+  """The network IDs to filter by."""
+  networks: [Int!]
+
+  """
+  The token IDs (`address:networkId`) or addresses to request the balance for. Only applied when using `walletAddress` and `networks` (not `walletId`).
+  """
+  tokens: [String!]
+
+  """Optional token specifically request the balance for."""
+  filterToken: String @deprecated(reason: "Use tokens list instead")
 
   """
   If set to true, native tokens in the response, they will have the id: native:<networkId>
   """
   includeNative: Boolean
+
+  """The maximum number of holdings to return."""
+  limit: Int
 }
 
 type BalancesResponse {
@@ -222,7 +239,7 @@ type BarsResponse {
   c: [Float]!
 
   """The volume."""
-  v: [Int]!
+  v: [Int]! @deprecated(reason: "Use volume field instead")
 
   """The timestamp for the bar."""
   t: [Int!]!
@@ -1188,6 +1205,9 @@ type EnhancedToken {
 
   """Whether or not the token is freezable"""
   freezable: String
+
+  """The launchpad data for the token, if applicable."""
+  launchpad: LaunchpadData
 }
 
 enum Entitlement {
@@ -1293,6 +1313,9 @@ type Event {
 
   """Labels attributed to the event."""
   labels: LabelsForEvent
+
+  """The age of the wallet in seconds."""
+  walletAge: Int
 }
 
 """Response returned by `getTokenEvents`."""
@@ -1419,6 +1442,9 @@ input EventsQueryInput {
   The total amount of `quoteToken` involved in the swap in USD (`amountNonLiquidityToken` x `priceUsd`).
   """
   priceUsdTotal: NumberFilter
+
+  """Specify the type of symbol you want to fetch values for (TOKEN | POOL)"""
+  symbolType: SymbolType
 }
 
 """The event type for a token transaction."""
@@ -1756,6 +1782,24 @@ type GetNetworkStatsResponse {
   """The network trade volume in USD over the past hour."""
   volume1: Float!
 
+  """The network trade volume in USD over the past 5 minutes."""
+  volume5m: Float!
+
+  """The network trade volume change over the last 24 hours"""
+  volumeChange24: Float!
+
+  """The network trade volume change over the last 12 hours"""
+  volumeChange12: Float!
+
+  """The network trade volume change over the last 4 hours"""
+  volumeChange4: Float!
+
+  """The network trade volume change over the last hour"""
+  volumeChange1: Float!
+
+  """The network trade volume change over the last 5 minutes"""
+  volumeChange5m: Float!
+
   """The network liquidity in USD."""
   liquidity: Float!
 
@@ -1770,6 +1814,9 @@ type GetNetworkStatsResponse {
 
   """The unique number of transactions in the past hour."""
   transactions1: Int!
+
+  """The unique number of transactions in the past 5 minutes."""
+  transactions5m: Int!
 }
 
 """Response returned by `getNftPoolCollectionsByExchange`."""
@@ -2219,6 +2266,107 @@ type LatestTokenSimResults {
   openTradingCall: String
 }
 
+type LaunchpadData {
+  """The name of the launchpad."""
+  name: String
+
+  """The percentage of the pool that was sold to the public."""
+  graduationPercent: Float
+
+  """The address of the pool."""
+  poolAddress: String
+
+  """The unix timestamp when the launchpad was completed."""
+  completedAt: Int
+
+  """Indicates if the launchpad is completed."""
+  completed: Boolean
+
+  """The slot number when the launchpad was completed."""
+  completedSlot: Int
+
+  """The slot number when the launchpad was migrated."""
+  migratedSlot: Int
+
+  """The unix timestamp when the launchpad was migrated."""
+  migratedAt: Int
+
+  """Indicates if the launchpad was migrated."""
+  migrated: Boolean
+
+  """The pool address after the launchpad was migrated."""
+  migratedPoolAddress: String
+
+  """The launchpad protocol"""
+  launchpadProtocol: String
+}
+
+"""Response returned by `onLaunchpadTokenEvent`."""
+type LaunchpadTokenEventOutput {
+  """The contract address of the token."""
+  address: String!
+
+  """The network ID that the token is deployed on."""
+  networkId: Int!
+
+  """The protocol of the token."""
+  protocol: String!
+
+  """Metadata for the token."""
+  token: EnhancedToken!
+
+  """The number of buys in the last 24 hours."""
+  buyCount1: Int
+
+  """The type of event."""
+  eventType: LaunchpadTokenEventType!
+
+  """The number of holders."""
+  holders: Int
+
+  """The market cap of the token."""
+  marketCap: String
+
+  """The price of the token."""
+  price: Float
+
+  """The number of sells in the last 24 hours."""
+  sellCount1: Int
+
+  """The volume of the token in the last 24 hours."""
+  volume1: Int
+
+  """The number of transactions in the last 24 hours."""
+  transactions1: Int
+}
+
+"""
+The type of event. Note that associated statistics such as `buyCount1`, `price`, etc. are only available for `Updated` events.
+"""
+enum LaunchpadTokenEventType {
+  """The token has been discovered"""
+  Deployed
+
+  """The token has been created with metadata"""
+  Created
+
+  """The token's statistics have been updated"""
+  Updated
+
+  """The token has been completed"""
+  Completed
+
+  """The token has been migrated"""
+  Migrated
+}
+
+"""The protocol of the token."""
+enum LaunchpadTokenProtocol {
+  Pump
+  FourMeme
+  RaydiumLaunchpad
+}
+
 scalar link__Import
 
 enum link__Purpose {
@@ -2265,7 +2413,10 @@ type LiquidityLock {
   lockProtocol: LiquidityLockProtocol!
 
   """The protocol that created the pair"""
-  liquidityProtocol: LiquidityProtocol!
+  liquidityProtocol: LiquidityProtocol! @deprecated(reason: "Use liquidityProtocolV2 instead")
+
+  """The protocol that created the pair"""
+  liquidityProtocolV2: String!
 
   """The amount of liquidity locked."""
   liquidityAmount: String!
@@ -2322,6 +2473,8 @@ enum LiquidityProtocol {
   UNISWAP_V3
   UNISWAP_V2
   RAYDIUM_V4
+  PUMP_V1
+  USE_LIQUIDITY_PROTOCOL_V2
 }
 
 """Response returned by `listPairsWithMetadataForToken`."""
@@ -6072,6 +6225,25 @@ input OneOfNumberConditionInput {
   oneOf: [Int!]!
 }
 
+"""Input for `onLaunchpadTokenEvent`."""
+input OnLaunchpadTokenEventInput {
+  """The protocol of the token."""
+  protocol: LaunchpadTokenProtocol
+
+  """The type of event."""
+  eventType: LaunchpadTokenEventType
+
+  """
+  The contract address of the token. Required when `networkId` is provided.
+  """
+  address: String
+
+  """
+  The network ID that the token is deployed on. Required when `address` is provided.
+  """
+  networkId: Int
+}
+
 input OnPricesUpdatedInput {
   address: String!
   networkId: Int!
@@ -6115,7 +6287,7 @@ type OnTokenBarsUpdatedResponse {
 }
 
 input OnTokenEventsCreatedInput {
-  tokenAddress: String!
+  tokenAddress: String
   networkId: Int!
 }
 
@@ -6438,6 +6610,48 @@ type PairFilterResult {
 
   """The trade volume in USD in the past 24 hours."""
   volumeUSD24: String
+
+  """The buy volume in USD in the past hour."""
+  buyVolumeUSD1: String
+
+  """The buy volume in USD in the past 12 hours."""
+  buyVolumeUSD12: String
+
+  """The buy volume in USD in the past 24 hours."""
+  buyVolumeUSD24: String
+
+  """The buy volume in USD in the past 4 hours."""
+  buyVolumeUSD4: String
+
+  """The sell volume in USD in the past hour."""
+  sellVolumeUSD1: String
+
+  """The sell volume in USD in the past 12 hours."""
+  sellVolumeUSD12: String
+
+  """The sell volume in USD in the past 24 hours."""
+  sellVolumeUSD24: String
+
+  """The sell volume in USD in the past 4 hours."""
+  sellVolumeUSD4: String
+
+  """The average age of the wallets that traded in the last 24h"""
+  walletAgeAvg: String
+
+  """
+  The standard deviation of age of the wallets that traded in the last 24h
+  """
+  walletAgeStd: String
+
+  """
+  The percentage of wallets that are less than 1d old that have traded in the last 24h
+  """
+  swapPct1dOldWallet: String
+
+  """
+  The percentage of wallets that are less than 7d old that have traded in the last 24h
+  """
+  swapPct7dOldWallet: String
 }
 
 """Input type of `PairFilters`."""
@@ -6598,11 +6812,58 @@ input PairFilters {
   """The trade volume in USD in the past 4 hours."""
   volumeUSD4: NumberFilter
 
+  """The buy volume in USD in the past hour."""
+  buyVolumeUSD1: NumberFilter
+
+  """The buy volume in USD in the past 12 hours."""
+  buyVolumeUSD12: NumberFilter
+
+  """The buy volume in USD in the past 24 hours."""
+  buyVolumeUSD24: NumberFilter
+
+  """The buy volume in USD in the past 4 hours."""
+  buyVolumeUSD4: NumberFilter
+
+  """The sell volume in USD in the past hour."""
+  sellVolumeUSD1: NumberFilter
+
+  """The sell volume in USD in the past 12 hours."""
+  sellVolumeUSD12: NumberFilter
+
+  """The sell volume in USD in the past 24 hours."""
+  sellVolumeUSD24: NumberFilter
+
+  """The sell volume in USD in the past 4 hours."""
+  sellVolumeUSD4: NumberFilter
+
   """Filter potential Scams"""
   potentialScam: Boolean
 
   """Whether to ignore pairs/tokens not relevant to trending"""
   trendingIgnored: Boolean
+
+  """
+  Whether to filter for pairs on testnet networks. Use `true` for testnet pairs only, `false` for mainnet pairs only and `undefined` (default) for both.
+  """
+  isTestnet: Boolean
+
+  """The average age of the wallets that traded in the last 24h"""
+  walletAgeAvg: NumberFilter
+
+  """
+  The standard deviation of age of the wallets that traded in the last 24h
+  """
+  walletAgeStd: NumberFilter
+
+  """
+  The percentage of wallets that are less than 1d old that have traded in the last 24h
+  """
+  swapPct1dOldWallet: NumberFilter
+
+  """
+  The percentage of wallets that are less than 7d old that have traded in the last 24h
+  """
+  swapPct7dOldWallet: NumberFilter
 }
 
 type PairMetadata {
@@ -6789,6 +7050,7 @@ enum PairRankingAttribute {
   sellCount12
   sellCount24
   trendingScore
+  trendingScore5m
   trendingScore1
   trendingScore4
   trendingScore12
@@ -6813,6 +7075,18 @@ enum PairRankingAttribute {
   volumeUSD4
   volumeUSD12
   volumeUSD24
+  buyVolumeUSD1
+  buyVolumeUSD4
+  buyVolumeUSD12
+  buyVolumeUSD24
+  sellVolumeUSD1
+  sellVolumeUSD4
+  sellVolumeUSD12
+  sellVolumeUSD24
+  walletAgeAvg
+  walletAgeStd
+  swapPct1dOldWallet
+  swapPct7dOldWallet
 }
 
 """Response returned by `filterNftParallelAssets`."""
@@ -8438,7 +8712,7 @@ type Query {
     """
     tokens: [String]
 
-    """A list of token IDs to exclude from results (`address:networkId`)"""
+    """A list of token IDs (`address:networkId`) to exclude from results"""
     excludeTokens: [String]
 
     """A list of ranking attributes to apply."""
@@ -8862,7 +9136,7 @@ type Query {
 
     """The offset to use for pagination."""
     offset: Int
-  ): LatestTokenConnection
+  ): LatestTokenConnection @deprecated(reason: "This query is no longer supported. Use `filterTokens` with a createdAt: DESC filter instead.")
 
   """Returns liquidity locks for a given pair."""
   liquidityLocks(
@@ -8887,6 +9161,9 @@ type Query {
     networkId: Int!
   ): LiquidityMetadata
 
+  """Returns a list of top traders for a given token."""
+  tokenTopTraders(input: TokenTopTradersInput!): TokenTopTradersConnection!
+
   """Returns community gathered notes."""
   getCommunityNotes(input: CommunityNotesInput): CommunityNotesResponse!
 }
@@ -9418,6 +9695,25 @@ type SparklineValue {
   value: Float!
 }
 
+type StarknetNetworkConfig {
+  id: ID!
+  networkId: Int!
+  baseTokenAddress: String!
+  baseTokenSymbol: String!
+  color: String
+  defaultPairAddress: String!
+  defaultPairQuoteToken: QuoteToken!
+  enabled: Boolean!
+  newTokensEnabled: Boolean
+  mainnet: Boolean!
+  name: String!
+  networkIconUrl: String!
+  networkName: String!
+  networkShortName: String!
+  stableCoinAddresses: [String!]
+  wrappedBaseTokenSymbol: String!
+}
+
 """Currency stats."""
 input statsCurrency {
   """The volume over the time frame."""
@@ -9600,6 +9896,9 @@ type Subscription {
 
     """docs: hide"""
     statsType: TokenPairStatisticsType
+
+    """The networkId to use when getting all bars per network"""
+    networkId: Int
   ): OnTokenBarsUpdatedResponse
 
   """Live-streamed transactions for a token."""
@@ -9612,6 +9911,9 @@ type Subscription {
 
     """The token of interest within the pair. Can be `token0` or `token1`."""
     quoteToken: QuoteToken
+
+    """The networkId to use when getting all events per network"""
+    networkId: Int
   ): AddEventsOutput
 
   """Live-streamed unconfirmed transactions for a token. (Solana only)"""
@@ -9699,6 +10001,9 @@ type Subscription {
   """
   onHoldersUpdated(tokenId: String!): HoldersUpdate
 
+  """Live-streamed balance updates for a given wallet."""
+  onBalanceUpdated(walletAddress: String!): Balance!
+
   """Live-streamed token lifecycle events (mints and burns)."""
   onTokenLifecycleEventsCreated(
     """The token contract address."""
@@ -9707,6 +10012,8 @@ type Subscription {
     """The network ID the token is deployed on."""
     networkId: Int
   ): AddTokenLifecycleEventsOutput!
+  onLaunchpadTokenEventBatch: [LaunchpadTokenEventOutput!]!
+  onLaunchpadTokenEvent(input: OnLaunchpadTokenEventInput): LaunchpadTokenEventOutput!
 }
 
 type SuiNetworkConfig {
@@ -10267,11 +10574,59 @@ type TokenFilterResult {
   """The trade volume in USD in the past 4 hours."""
   volume4: String
 
+  """The buy volume in USD in the past hour."""
+  buyVolume1: String
+
+  """The buy volume in USD in the past 12 hours."""
+  buyVolume12: String
+
+  """The buy volume in USD in the past 24 hours."""
+  buyVolume24: String
+
+  """The buy volume in USD in the past 4 hours."""
+  buyVolume4: String
+
+  """The buy volume in USD in the past 5 minutes."""
+  buyVolume5m: String
+
+  """The sell volume in USD in the past hour."""
+  sellVolume1: String
+
+  """The sell volume in USD in the past 12 hours."""
+  sellVolume12: String
+
+  """The sell volume in USD in the past 24 hours."""
+  sellVolume24: String
+
+  """The sell volume in USD in the past 4 hours."""
+  sellVolume4: String
+
+  """The sell volume in USD in the past 5 minutes."""
+  sellVolume5m: String
+
   """Whether the token has been flagged as a scam."""
   isScam: Boolean
 
   """The number of different wallets holding the token."""
   holders: Int
+
+  """The average age of the wallets that traded in the last 24h"""
+  walletAgeAvg: String
+
+  """
+  The standard deviation of age of the wallets that traded in the last 24h
+  """
+  walletAgeStd: String
+
+  """
+  The percentage of wallets that are less than 1d old that have traded in the last 24h
+  """
+  swapPct1dOldWallet: String
+
+  """
+  The percentage of wallets that are less than 7d old that have traded in the last 24h
+  """
+  swapPct7dOldWallet: String
 }
 
 """Input type of `TokenFilters`."""
@@ -10477,11 +10832,46 @@ input TokenFilters {
   """The trade volume in USD in the past 5 minutes."""
   volume5m: NumberFilter
 
+  """The buy volume in USD in the past hour."""
+  buyVolume1: NumberFilter
+
+  """The buy volume in USD in the past 12 hours."""
+  buyVolume12: NumberFilter
+
+  """The buy volume in USD in the past 24 hours."""
+  buyVolume24: NumberFilter
+
+  """The buy volume in USD in the past 4 hours."""
+  buyVolume4: NumberFilter
+
+  """The buy volume in USD in the past 5 minutes."""
+  buyVolume5m: NumberFilter
+
+  """The sell volume in USD in the past hour."""
+  sellVolume1: NumberFilter
+
+  """The sell volume in USD in the past 12 hours."""
+  sellVolume12: NumberFilter
+
+  """The sell volume in USD in the past 24 hours."""
+  sellVolume24: NumberFilter
+
+  """The sell volume in USD in the past 4 hours."""
+  sellVolume4: NumberFilter
+
+  """The sell volume in USD in the past 5 minutes."""
+  sellVolume5m: NumberFilter
+
   """
   Whether to include tokens that have been flagged as scams. Default: false
   """
   includeScams: Boolean
 
+  """
+  Whether to filter for tokens on testnet networks. Use `true` for testnet tokens only, `false` for mainnet tokens only and `undefined` (default) for both.
+  """
+  isTestnet: Boolean
+
   """Only include verified tokens"""
   isVerified: Boolean
 
@@ -10493,6 +10883,48 @@ input TokenFilters {
 
   """The address of the creator of the token"""
   creatorAddress: String
+
+  """The launchpad protocol"""
+  launchpadProtocol: String
+
+  """Indicates if the launchpad is completed"""
+  launchpadCompleted: Boolean
+
+  """Indicates if the launchpad has migrated"""
+  launchpadMigrated: Boolean
+
+  """The graduation percentage"""
+  launchpadGraduationPercent: NumberFilter
+
+  """The timestamp when the launchpad was completed"""
+  launchpadCompletedAt: NumberFilter
+
+  """The timestamp when the launchpad was migrated"""
+  launchpadMigratedAt: NumberFilter
+
+  """The token in freezable"""
+  freezable: Boolean
+
+  """The token in mintable"""
+  mintable: Boolean
+
+  """The average age of the wallets that traded in the last 24h"""
+  walletAgeAvg: NumberFilter
+
+  """
+  The standard deviation of age of the wallets that traded in the last 24h
+  """
+  walletAgeStd: NumberFilter
+
+  """
+  The percentage of wallets that are less than 1d old that have traded in the last 24h
+  """
+  swapPct1dOldWallet: NumberFilter
+
+  """
+  The percentage of wallets that are less than 7d old that have traded in the last 24h
+  """
+  swapPct7dOldWallet: NumberFilter
 }
 
 """Metadata for a token."""
@@ -10765,6 +11197,7 @@ enum TokenRankingAttribute {
   sellCount12
   sellCount24
   trendingScore
+  trendingScore5m
   trendingScore1
   trendingScore4
   trendingScore12
@@ -10794,6 +11227,23 @@ enum TokenRankingAttribute {
   volume4
   volume12
   volume24
+  buyVolume5m
+  buyVolume1
+  buyVolume4
+  buyVolume12
+  buyVolume24
+  sellVolume5m
+  sellVolume1
+  sellVolume4
+  sellVolume12
+  sellVolume24
+  launchpadCompletedAt
+  launchpadMigratedAt
+  graduationPercent
+  walletAgeAvg
+  walletAgeStd
+  swapPct1dOldWallet
+  swapPct7dOldWallet
 }
 
 """Response returned by `searchTokens`."""
@@ -10830,6 +11280,93 @@ input TokenSparklineInput {
   ids: [String!]!
 }
 
+"""A top trader for a token."""
+type TokenTopTrader {
+  """The wallet address of the trader."""
+  walletAddress: String!
+
+  """The token address."""
+  tokenAddress: String!
+
+  """The network ID."""
+  networkId: Int!
+
+  """The amount of tokens bought."""
+  tokenAmountBought: String!
+
+  """The amount of tokens sold."""
+  tokenAmountSold: String!
+
+  """The amount of tokens bought in USD."""
+  amountBoughtUsd: String!
+
+  """The amount of tokens sold in USD."""
+  amountSoldUsd: String!
+
+  """The volume of tokens bought and sold in USD."""
+  volumeUsd: String!
+
+  """The realized profit in USD."""
+  realizedProfitUsd: String!
+
+  """The realized profit percentage."""
+  realizedProfitPercentage: Float!
+
+  """The single token acquisition cost in USD."""
+  singleTokenAcquisitionCostUsd: String!
+
+  """The number of buys."""
+  buys: Int!
+
+  """The number of sells."""
+  sells: Int!
+
+  """The token balance of the trader."""
+  tokenBalance: String!
+
+  """The unix timestamp for the first transaction from this wallet."""
+  firstTransactionAt: Int
+
+  """The unix timestamp for the last transaction from this wallet."""
+  lastTransactionAt: Int!
+}
+
+"""A paginated list of top traders for a token."""
+type TokenTopTradersConnection {
+  """The token address."""
+  tokenAddress: String!
+
+  """The network ID."""
+  networkId: Int!
+
+  """The trading period."""
+  tradingPeriod: TradingPeriod!
+
+  """The list of top traders."""
+  items: [TokenTopTrader]!
+
+  """The offset of the first trader in the connection."""
+  offset: Int
+}
+
+"""Input arguments for the `tokenTopTraders` query."""
+input TokenTopTradersInput {
+  """The token address"""
+  tokenAddress: String!
+
+  """The network ID"""
+  networkId: Int!
+
+  """The trading period"""
+  tradingPeriod: TradingPeriod!
+
+  """The number of traders to return"""
+  limit: Int
+
+  """Where in the list the server started when returning items"""
+  offset: Int
+}
+
 """A token with metadata."""
 type TokenWithMetadata {
   """The contract address of the token."""
@@ -10951,6 +11488,14 @@ type TokenWithMetadata {
   lastTransaction: Int
 }
 
+"""A time period used when calculating wallet trading data."""
+enum TradingPeriod {
+  DAY
+  WEEK
+  MONTH
+  YEAR
+}
+
 """An unconfirmed token transaction."""
 type UnconfirmedEvent {
   """The contract address of the token's top pair."""