> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Recent changes and updates to the Codex API

You can subscribe to the RSS changelog at [/changelog/rss.xml](/changelog/rss.xml) to stay on top of any weekly updates.

<Update label="July 6, 2026" description="Robinhood Chain support, filter token removal signals, actual shares held on prediction stats">
  * **Robinhood Chain supported**. Robinhood Chain (chain ID `4663`) is now available across Codex APIs. See the full list on [Networks](/networks).
  * **Token removal signals on `onFilterTokensUpdated`**. [`FilterTokenUpdates`](/api-reference/types/filtertokenupdates) now returns `removedTokenIds`, the IDs of tokens that no longer match your subscription parameters when the result set is refreshed. The `updates` list also now includes full results for tokens that newly match, so client-side result sets stay in sync without a resubscribe.
  * **`actualSharesHeld` on prediction trader stats**. [`PredictionTraderOutcomeStats`](/api-reference/types/predictiontraderoutcomestats) and [`PredictionTraderOutcomeFilterResult`](/api-reference/types/predictiontraderoutcomefilterresult) now expose `actualSharesHeld` alongside `sharesHeld`. Use it to track shares a trader still holds when PnL has been calculated but positions haven't been redeemed.
</Update>

<Update label="June 29, 2026" description="Token-2022 scaled UI amounts, token extensions, 24h price change, wallet category filter, Base bar Flashblocks, EasyA Kickstart">
  * **Token-2022 scaled UI amounts**. [`Balance`](/api-reference/types/balance) now exposes `uiBalance`, and [`BalancesInput`](/api-reference/input-objects/balancesinput) accepts a new `uiAmountMode` ([`UiAmountMode`](/api-reference/enums/uiamountmode)) to choose between the stored RPC UI amount (`SCALED`, default) or raw amounts with Token-2022 UI multipliers removed (`RAW`). Solana Token-2022 mints with a scaled UI amount configuration now display correctly out of the box.
  * **Token extension metadata**. [`EnhancedToken`](/api-reference/types/enhancedtoken) now exposes `extensions` ([`TokenExtensions`](/api-reference/types/tokenextensions)) with Solana Token-2022 scaled UI amount config and Base B20 rebasing multipliers, plus `tokenStandardCustomData` ([`Erc7572CustomInfo`](/api-reference/types/erc7572custominfo)) returning ERC-7572 `contractURI` fields (featured image, collaborators) for Base B20 tokens.
  * **24h price change on `Price`**. [`Price`](/api-reference/types/price) now includes `priceChange24`, the decimal percent change over the past 24 hours. Not available via subscription.
  * **Filter and rank wallets by behavior category**. [`WalletFilters`](/api-reference/input-objects/walletfilters) now accepts `categories: [WalletCategory!]`, and [`WalletFilterResult`](/api-reference/types/walletfilterresult) now returns `category`, `tokensCreatedCount`, and `tokensMigratedCount` so [`filterWallets`](/api-reference/queries/filterwallets) responses surface the same classification and creator metrics used for filtering.
  * **Base Flashblocks for bar subscriptions**. The `Processed` [`BarCommitmentLevel`](/api-reference/enums/barcommitmentlevel) now returns Base Flashblocks, so [`onBarsUpdated`](/api-reference/subscriptions/onbarsupdated) and [`onTokenBarsUpdated`](/api-reference/subscriptions/ontokenbarsupdated) can stream unconfirmed Base bars ahead of `Confirmed`. Use only when earliest signal matters more than finality.
  * **EasyA Kickstart launchpad supported**. Added to `launchpadName` filters on [`filterTokens`](/api-reference/queries/filtertokens) and to [`onLaunchpadTokenEvent`](/api-reference/subscriptions/onlaunchpadtokenevent) / [`onLaunchpadTokenEventBatch`](/api-reference/subscriptions/onlaunchpadtokeneventbatch) subscriptions.
</Update>

<Update label="June 22, 2026" description="Base Flashblocks events, Balance enhancements, Preprocessed bar commitment, 1-year wallet stats migration">
  * **Base Flashblocks for event streams**. The `Processed` [`EventCommitmentLevel`](/api-reference/enums/eventcommitmentlevel) now returns Base Flashblocks, so [`onEventsCreated`](/api-reference/subscriptions/oneventscreated), [`onEventsCreatedByMaker`](/api-reference/subscriptions/oneventscreatedbymaker), and [`onTokenEventsCreated`](/api-reference/subscriptions/ontokeneventscreated) can stream unconfirmed Base events ahead of `Confirmed`. Flashblock events are pre-confirmation and may differ from later commitments — use only when earliest signal matters more than finality.
  * **Token activity and wallet identity on balances**. [`Balance`](/api-reference/types/balance) now exposes `tokenLastTradedTimestamp` so you can filter out dead or worthless tokens with no recent market activity, plus a resolved `wallet` field with identity and profile metadata for the holding wallet.
  * **`Preprocessed` commitment level for Solana bar subscriptions**. `BarCommitmentLevel` now includes `Preprocessed`, letting bar updates stream at the earliest pre-execution stage. Preprocessed bars may differ from later commitments — use only when earliest signal matters more than accuracy.
  * **New 1-year wallet stats window**. [`DetailedWalletStats`](/api-reference/types/detailedwalletstats) and [`NetworkBreakdown`](/api-reference/types/networkbreakdown) now expose `statsYear` returning [`WindowedWalletStatsYear`](/api-reference/types/windowedwalletstatsyear). Migrate off `statsYear1` before it is removed on July 10, 2026.
  * **`uniqueTokens1y` deprecated**. The 1-year unique tokens metric on [`WalletFilters`](/api-reference/input-objects/walletfilters), [`WalletNetworkFilters`](/api-reference/input-objects/walletnetworkfilters), [`WalletFilterResult`](/api-reference/types/walletfilterresult), [`NetworkWalletFilterResult`](/api-reference/types/networkwalletfilterresult), and the related ranking attributes is deprecated and will be removed on July 10, 2026.
</Update>

<Update label="June 15, 2026" description="Token-creator wallet filters, token lifecycle events deprecation">
  * **Filter wallets by token-creator activity**. [`filterWallets`](/api-reference/queries/filterwallets) now accepts `tokensCreatedCount` and `tokensMigratedCount` on [`WalletFilters`](/api-reference/input-objects/walletfilters), letting you target wallets by how many tokens they've deployed or graduated from a launchpad across all networks.
  * **Token lifecycle events deprecated**. [`tokenLifecycleEvents`](/api-reference/queries/tokenlifecycleevents) and [`onTokenLifecycleEventsCreated`](/api-reference/subscriptions/ontokenlifecycleeventscreated) are now marked deprecated. Support will be removed on July 15, 2026 — migrate to the standard token event queries and subscriptions before then.
</Update>

<Update label="June 8, 2026" description="Suspicious wallet stats, wallet category, preprocessed commitment level, creator wallet on tokens, Flap launchpad">
  * **Suspicious wallet stats on tokens**. `suspiciousCount` and `suspiciousHeldPercentage` — the deduplicated union of snipers, bundlers, and insiders — are now exposed on [`EnhancedToken`](/api-reference/types/enhancedtoken), [`TokenWalletActivity`](/api-reference/types/tokenwalletactivity), and [`LaunchpadTokenEventOutput`](/api-reference/types/launchpadtokeneventoutput), available as filters and ranking attributes on [`filterTokens`](/api-reference/queries/filtertokens). Use it to screen out tokens with high concentration in risky wallet cohorts in a single check.
  * **Resolved creator wallet on tokens**. [`EnhancedToken`](/api-reference/types/enhancedtoken) now returns a `creator` field of type [`Wallet`](/api-reference/types/wallet), resolved from `creatorAddress`. [`LaunchpadTokenEventOutput`](/api-reference/types/launchpadtokeneventoutput) gains a matching `devWallet` field, so you can pull creator identity, labels, and stats inline without a follow-up query.
  * **Wallet category classification**. [`Wallet`](/api-reference/types/wallet) now exposes a `category` field returning a new `WalletCategory` enum (`NORMIE`, `TOKEN_CREATOR`, `EXCHANGE`, `DEFI_EXCHANGE`, `PAIR`, `PAIR_TOKEN_HOLDER`, `POOL_AUTHORITY`, `STAKING_VAULT`, `NOTORIOUS`) for behavioral classification at a glance.
  * **Token-creator stats on wallets**. [`Wallet`](/api-reference/types/wallet) now returns `tokensCreatedCount` and `tokensMigratedCount` — totals across all networks for tokens deployed and launchpad tokens graduated by the wallet.
  * **New token ranking attributes**. [`filterTokens`](/api-reference/queries/filtertokens) adds rankings for `sniperHeldPercentage`, `bundlerHeldPercentage`, `insiderHeldPercentage`, `suspiciousHeldPercentage`, `devHeldPercentage`, and their matching `*Count` attributes, plus community-engagement rankings `coinCommunityPostCount`, `coinCommunityMemberCount`, `coinCommunityLikeCount`, and `coinCommunityLastPostAt`.
  * **`Preprocessed` Solana commitment level**. `EventCommitmentLevel` now includes `Preprocessed` for event subscriptions, surfacing pre-execution events earlier than `Processed` or `Confirmed`. Preprocessed events evaluate before routing is finalized and may differ from later commitment stages — many preprocessed events may error and never be processed, so use only when earliest-possible signal matters more than accuracy.
  * **Flap launchpad support added**. Added to `launchpadName` filters on [`filterTokens`](/api-reference/queries/filtertokens) and to launchpad event subscriptions.
</Update>

<Update label="June 1, 2026" description="Prediction market metrics webhooks, NFT event webhooks removed">
  * **Prediction market metrics event webhooks**. [`createWebhooks`](/api-reference/mutations/createwebhooks) now accepts `predictionMarketMetricsEventWebhooksInput`, letting you alert on rolling windowed stats (5m to 1w) at the market or per-outcome level (with `outcome0`, `outcome1`, or `anyOutcome` matching). Use this to trigger on volume spikes, price moves, or trade counts on a specific Polymarket or Kalshi market without polling. See [Webhooks](/concepts/webhooks) for setup.
  * **NFT event webhooks removed**. `nftEventWebhooksInput` and the related `CreateNftEventWebhookArgs`, `NftEventWebhookCondition`, `WebhookNftEventType`, and `WebhookNftEventFillSource` types are no longer part of the schema, following the previously announced sunset of NFT data coverage on March 31, 2026. Existing NFT-event-webhook code paths should be migrated off.
</Update>

<Update label="May 25, 2026" description="HMAC webhook signatures, Kalshi order books, average hold period stats, Meteora Alpha Vault launchpad">
  * **HMAC webhook signature verification**. Webhook deliveries now include `X-Webhook-Timestamp` and `X-Webhook-Signature` headers, where the signature is an HMAC-SHA256 over `{timestamp}.{rawBody}` keyed by your webhook's `securityToken`. This authenticates the exact raw body and supports a 300-second freshness check, replacing the legacy body `hash` field (which is now deprecated and only identifies the delivery, not the body). See [Verifying webhooks](/concepts/webhooks#verifying-webhooks) for the verification flow, a Node example, and raw-body capture notes for common frameworks.
  * **Kalshi support for live order books**. [`predictionOutcomeOrderBooks`](/api-reference/queries/predictionoutcomeorderbooks) and the related `bestBookBid*` / `bestBookAsk*` / `bestBookLiquidity*` fields on prediction markets and outcomes now return live data for Kalshi outcomes in addition to Polymarket. Outcomes from other venues continue to return null.
  * **Average hold period fields on wallets and tokens**. Wallet, token, and trader aggregate types now expose `avgHoldPeriodSec` along with `avgHoldPeriodSec1d`, `avgHoldPeriodSec1w`, `avgHoldPeriodSec30d`, and `avgHoldPeriodSec1y` — cost-basis turnover time in seconds across rolling windows. The same fields are available as filters and rankings on [`filterTokens`](/api-reference/queries/filtertokens) and wallet queries, so you can screen for short-term flippers versus long-term holders.
  * **Meteora Alpha Vault** added to the supported launchpad list across token and launchpad filters.
</Update>

<Update label="May 18, 2026" description="Sports metadata on prediction events and markets, identityLabels on wallets, optional firehose for onPredictionTradesCreated">
  * **Sports metadata on prediction events and markets**. [`PredictionEvent`](/api-reference/types/predictionevent) and [`PredictionMarket`](/api-reference/types/predictionmarket) now expose an `enrichedMetadata` field returning [`PredictionEventEnrichedMetadata`](/api-reference/types/predictioneventenrichedmetadata) and [`PredictionMarketEnrichedMetadata`](/api-reference/types/predictionmarketenrichedmetadata). For sports markets, this includes structured team info (name, abbreviations, alias, logo, color, league, home/away flag), league, game start date/time/timezone, and a decomposed venue ticker — so you no longer need to parse venue tickers client-side to render scoreboards or filter by team.
  * **`identityLabels` added to wallet filter results**. [`WalletFilterResult`](/api-reference/types/walletfilterresult) now returns an `identityLabels` field exposing manual or proposal-derived identity vocabulary (for example `WHALE`, `KOL`), distinct from the existing behavioral `labels`.
  * **Firehose mode for [`onPredictionTradesCreated`](/api-reference/subscriptions/onpredictiontradescreated)**. The `input` argument is now optional — omit it to receive the firehose of all prediction trades instead of being required to scope by market, event, or trader.
</Update>

<Update label="May 11, 2026" description="predictionOutcomeOrderBooks, token ATH/ATL data, Polymarket order book fields, Meteora Alpha Vault">
  * **[`predictionOutcomeOrderBooks`](/api-reference/queries/predictionoutcomeorderbooks) query added**. Returns live order book snapshots (full bid/ask ladders) for a set of prediction outcomes, sourced directly from the venue's CLOB. Polymarket-only for now; results are cached for up to 10 seconds. New [`PredictionOutcomeOrderBook`](/api-reference/types/predictionoutcomeorderbook) and [`PredictionOrderBookLevel`](/api-reference/types/predictionorderbooklevel) types accompany it.
  * **All-time high and low data added to tokens**. [`EnhancedToken`](/api-reference/types/enhancedtoken) now exposes an `extrema` field returning a new [`TokenExtrema`](/api-reference/types/tokenextrema) type with `athPrice`, `atlPrice`, `athFdv`, `atlFdv`, `athCircMc`, `atlCircMc`, and matching `*Timestamp` fields for each. The same attributes are also available as filter inputs on [`filterTokens`](/api-reference/queries/filtertokens), so you can screen by ATH/ATL price or market cap.
  * **Top-of-book Polymarket data added to prediction markets**. Prediction market and outcome types now expose `bestBookBidUsd` / `bestBookBidCT`, `bestBookAskUsd` / `bestBookAskCT`, and `bookLiquidityUsd` / `bookLiquidityCT` for live top-of-book pricing and bid-side notional liquidity. Polymarket-only for now, fetched on-demand when selected, cached for up to 10 seconds.
  * **`commitmentLevel` argument added to [`onTokenBarsUpdated`](/api-reference/subscriptions/ontokenbarsupdated)**. Token-level bar subscriptions can now request `Processed`, `Confirmed`, or both Solana commitment levels, matching the existing `onBarsUpdated` / `onEventsCreated` / `onEventsCreatedByMaker` interface.
  * **Meteora Alpha Vault launchpad support added**. Added to `launchpadName` filters on [`filterTokens`](/api-reference/queries/filtertokens) and to launchpad event subscriptions.
</Update>

<Update label="May 4, 2026" description="eventScopedFilterPredictionMarkets, token boolean filters, Eitherway launchpad">
  * **[`eventScopedFilterPredictionMarkets`](/api-reference/queries/eventscopedfilterpredictionmarkets) query added**. Filters prediction markets within a single event and returns structured classification metadata for each market — including entrant info (with country code and image), period/stat segments, parsed numeric threshold rungs, and date buckets. Use this instead of [`filterPredictionMarkets`](/api-reference/queries/filterpredictionmarkets) when you need entrant/segment/ladder details without re-parsing subtype slugs client-side.
  * **Boolean filter composition added to [`filterTokens`](/api-reference/queries/filtertokens)**. `TokenFilters` now accepts a `boolFilter` field that combines nested `TokenFilters` with `and`, `or`, and `not` for recursive boolean expressions, enabling much richer token-discovery queries.
  * **`marketSort` argument on [`filterPredictionEvents`](/api-reference/queries/filterpredictionevents) deprecated**. The argument and its `PredictionEventMarketSort` enum no longer affect market ordering within returned events.
  * **Eitherway launchpad support added**. Added to `launchpadName` filters on [`filterTokens`](/api-reference/queries/filtertokens) and to launchpad event subscriptions.
</Update>

<Update label="Apr 27, 2026" description="Polymarket wallet profiles, venue-reported prediction market volume">
  * **Polymarket profile data added to wallets**. The [`Wallet`](/api-reference/types/wallet) type now exposes a `polymarket` field returning a new [`WalletPolymarketProfile`](/api-reference/types/walletpolymarketprofile) type with the proxy wallet address, Polymarket display name, pseudonym, profile image, X (Twitter) username, verified badge, and public-display flag. Polymarket profile data takes priority over contributed/Ethos sources for resolved `displayName`, `twitterUsername`, and `avatarUrl`.
  * **Venue-reported volume added to prediction market bars**. [`PredictionMarketBar`](/api-reference/types/predictionmarketbar) now exposes `allTimeVenueVolumeUsd` and `allTimeVenueVolumeCollateralToken` alongside the existing on-chain `allTimeVolumeUsd` and `allTimeVolumeCollateralToken`, letting you compare Codex-indexed on-chain volume against the volume reported by the venue.
</Update>

<Update label="Apr 20, 2026" description="commitment-level streaming, walletLabelTypes, launchpad fee breakdown, The Grid integration">
  * **[`walletLabelTypes`](/api-reference/queries/walletlabeltypes) query added**. Returns the canonical vocabulary of wallet label types (for example `WHALE`, `CEX`, `KOL`) with display names and descriptions.
  * **Solana commitment-level streaming added**. [`onBarsUpdated`](/api-reference/subscriptions/onbarsupdated), [`onEventsCreated`](/api-reference/subscriptions/oneventscreated), and [`onEventsCreatedByMaker`](/api-reference/subscriptions/oneventscreatedbymaker) now accept a `commitmentLevel` argument (`Processed`, `Confirmed`), and streamed payloads expose a matching `commitmentLevel` field. The standalone [`onUnconfirmedBarsUpdated`](/api-reference/subscriptions/onunconfirmedbarsupdated), [`onUnconfirmedEventsCreated`](/api-reference/subscriptions/onunconfirmedeventscreated), and [`onUnconfirmedEventsCreatedByMaker`](/api-reference/subscriptions/onunconfirmedeventscreatedbymaker) subscriptions are now deprecated.
  * **`getLatestPairs` and `onLatestPairUpdated` removed**. Both were previously deprecated — use [`filterPairs`](/api-reference/queries/filterpairs) sorted by `createdAt DESC` instead.
  * **Fee breakdown added to launchpad token events**. [`LaunchpadTokenEventOutput`](/api-reference/types/launchpadtokeneventoutput) now exposes `poolFees1`, `baseFees1`, `priorityFees1`, `builderTips1`, `l1DataFees1`, `totalFees1`, and `feeToVolumeRatio1` for 1-hour fee and MEV analysis on launchpad streams.
  * **USD-denominated fields added to prediction top markets**. [`PredictionEventTopMarket`](/api-reference/types/predictioneventtopmarket) now returns `outcome0BidUSD`/`outcome0AskUSD`, `outcome1BidUSD`/`outcome1AskUSD`, and `volumeUSD1d`/`volumeUSD1w`/`volumeUSDAll` alongside the existing collateral-token values.
  * **Phrase-match ranking for prediction search**. New `phraseScore` attribute on both `PredictionEventRankingAttribute` and `PredictionMarketRankingAttribute` enables relevance-based sorting when searching prediction events and markets by phrase.
  * **Wallet social-account filters and `ethosScore` ranking added**. [`filterWallets`](/api-reference/queries/filterwallets) now accepts `hasTwitter`, `hasDiscord`, `hasTelegram`, `hasFarcaster`, `hasGithub`, `hasDisplayName`, and `hasSocials` filters, and `ethosScore` is available as a ranking attribute.
  * **Token profanity flag added**. [`EnhancedToken`](/api-reference/types/enhancedtoken) includes a new `profanity` boolean, and `TokenFilters.profanity` lets you filter by whether the token name or symbol contains profanity.
  * **Scale launchpad support added**. Added to `launchpadName` filters on [`filterTokens`](/api-reference/queries/filtertokens) and to launchpad event subscriptions; [`LaunchpadData`](/api-reference/types/launchpaddata) now exposes `category`, the launchpad-assigned token category returned by Scale and Creator launchpads.
  * **The Grid integration**. Token and organization metadata on [`filterTokens`](/api-reference/queries/filtertokens), [`token`](/api-reference/queries/token), and [`tokens`](/api-reference/queries/tokens) is now enriched by [The Grid](https://thegrid.id/), a human-verified Web3 ecosystem intelligence platform. When Grid data is available, queries return `asset` (verified token metadata including description, icon, and cross-chain deployments), `assetDeployments` (all networks and addresses the token is deployed on), and `organization` (metadata about the issuing organization including URLs and socials). Covers established verified projects only.
</Update>

<Update label="Apr 10, 2026" description="predictionMarketPrice, bar fee breakdown, onFilterTokenUpdated">
  * **`predictionMarketPrice` query added**. Fetch current or point-in-time price data for a prediction market, including best bid, best ask, last trade price, and spread in both USD and collateral token units.
  * **Fee breakdown fields added to bar data**. Bar types now expose `poolFees`, `baseFees`, `priorityFees`, `builderTips`, `l1DataFees`, `totalFees`, and derived metrics including `feeToVolumeRatio`, `mevToTotalFeesRatio`, `gasPerVolume`, `averageCostPerTrade`, `mevRiskLevel`, `feeRegimeClassification`, and `sandwichRate` for detailed cost and MEV analysis.
  * **[`OnFilterTokensUpdated`](https://docs.codex.io/api-reference/subscriptions/onfiltertokensupdated) subscription added**. Live-streams updates to the current [`filterTokens`](/api-reference/queries/filtertokens) result set — requires `useAggregatedStats: true`.
</Update>

<Update label="Mar 2026" description="Prediction markets, getDetailedTokenStats, useAggregatedStats">
  * **Prediction market endpoints released**. Full suite of queries and subscriptions for prediction market data:
    * Queries: [`filterPredictionEvents`](/api-reference/queries/filterpredictionevents), [`filterPredictionMarkets`](/api-reference/queries/filterpredictionmarkets), [`filterPredictionTraders`](/api-reference/queries/filterpredictiontraders), [`filterPredictionTraderMarkets`](/api-reference/queries/filterpredictiontradermarkets)
    * Detail queries: [`detailedPredictionMarketStats`](/api-reference/queries/detailedpredictionmarketstats), [`detailedPredictionEventStats`](/api-reference/queries/detailedpredictioneventstats), [`detailedPredictionTraderStats`](/api-reference/queries/detailedpredictiontraderstats)
    * Bar data: [`predictionMarketBars`](/api-reference/queries/predictionmarketbars), [`predictionEventBars`](/api-reference/queries/predictioneventbars), [`predictionTraderBars`](/api-reference/queries/predictiontraderbars), [`predictionEventTopMarketsBars`](/api-reference/queries/predictioneventtopmarketsbars)
    * Lookups: [`predictionMarkets`](/api-reference/queries/predictionmarkets), [`predictionTraders`](/api-reference/queries/predictiontraders), [`predictionTrades`](/api-reference/queries/predictiontrades), [`predictionTokenHolders`](/api-reference/queries/predictiontokenholders), [`predictionTraderHoldings`](/api-reference/queries/predictiontraderholdings), [`predictionTraderMarketsStats`](/api-reference/queries/predictiontradermarketsstats), [`predictionCategories`](/api-reference/queries/predictioncategories)
    * Subscriptions: [`onPredictionTradesCreated`](/api-reference/subscriptions/onpredictiontradescreated), [`onDetailedPredictionMarketStatsUpdated`](/api-reference/subscriptions/ondetailedpredictionmarketstatsupdated), [`onDetailedPredictionEventStatsUpdated`](/api-reference/subscriptions/ondetailedpredictioneventstatsupdated), [`onPredictionMarketBarsUpdated`](/api-reference/subscriptions/onpredictionmarketbarsupdated), [`onPredictionEventBarsUpdated`](/api-reference/subscriptions/onpredictioneventbarsupdated)
  * [`getDetailedTokenStats`](/api-reference/queries/getdetailedtokenstats) query released — returns bucketed stats aggregated across all pairs for a token, with support for multiple durations (`min5`, `min15`, `hour1`, `hour4`, `hour12`, `day1`, `week1`, `day30`)
  * [`onDetailedTokenStatsUpdated`](/api-reference/subscriptions/ondetailedtokenstatsupdated) subscription released — live-streamed equivalent of `getDetailedTokenStats`
  * Added `useAggregatedStats` flag to [`filterTokens`](/api-reference/queries/filtertokens) to opt into aggregated token stats
  * NFT data coverage deprecated. NFT endpoints will be removed on March 31, 2026
  * Added support for Tempo (network ID 4217)
  * Added the [Codex Skills](/agents/codex-skills) and [MPP](/agents/mpp) (Machine Payments Protocol) payment support. You can now use Codex directly in LLMs with either an API key or USDC on Tempo
</Update>

<Update label="Feb 2026" description="MegaETH, Top 10 Holders, new protocols">
  * Added support for the following protocols: Coinbarrel, Noice, Blowfish
  * Rolled out expanded support for Top 10 Holders Percent:
    * Added to the [`onPairMetadataUpdated`](/api-reference/subscriptions/onpairmetadataupdated) subscription and to [`filterTokens`](/api-reference/queries/filtertokens)
    * Fixed a bug with SOL case sensitivity
  * Added support for 'Bonkers' mode tokens from Bonk.fun
  * Added support for the bankr launchpad
  * Fixed a bug with [`getTokenEventsForMaker`](/api-reference/queries/gettokeneventsformaker) — it now uses a mix of the first token event (mint) and last pair event to create the window that is searched
  * Top holders now correctly excludes vault addresses
  * Negative holder count fix
  * Added support for swap pricing of 29 more SVM protocols & added to trending
  * MegaETH support added, including Kumbaya launchpad
</Update>

<Update label="Jan 2026" description="Fogo mainnet, maker attribution, Meteora DAMMv2 locks">
  * Fogo mainnet support added (Network ID: 150601)
  * Meteora DAMMv2 liquidity lock tracking
  * Historical bar fetching for [`GetTokenBars`](/api-reference/queries/gettokenbars)
  * Removed social connection requirement for signup
  * Shipped maker attribution logic for aggregated transactions
  * Added support for TokenMill EVM memescope
  * Added the following protocols with generic swap pricing support: AlphaQ, Byreal CLMM, BisonFi, Orbic V2, Swap, Stabble, ZeroFi, and PancakeSwap (hidden from trending/top pair due to lack of historical data)
</Update>

<Update label="Dec 2025" description="pump.fun fixes, webhook improvements">
  * Added support for a pump.fun swap instruction that we were missing
  * Fixed event not being recorded for pump.fun mayhem burns
  * Fixed bug & repaired data from pump.fun graduations failing to record events
  * Webhook usage/details improvements:
    * List view of user's webhooks in dashboard
    * Detail view of a webhook in dashboard
    * Webhook activity service and activity view in details
  * Improved query request/response examples in Codex docs
  * Added integrator disambiguation for Doppler launchpads
  * Fixed a pump.fun problem after they updated their contract
  * Fixed PnL totals calculation accuracy
  * Added auto disabling to failing test webhooks
  * New token pricing webhook live in prod
  * Dashboard changes for webhooks:
    * Global webhooks admin view
    * New token pricing event type
    * Updated docs for new pricing event
  * Fixed bug in balances endpoint that was letting scam tokens through when `removeScams` was true
</Update>

<Update label="Nov 2025" description="Bundlers/snipers/insiders data, pump.fun Mayhem, SDK 2.0">
  * Bundlers/Snipers/Insiders data types added to [`filterTokens`](/api-reference/queries/filtertokens) and both launchpad event subscriptions — not backfilled
  * Added [`firstSeenTimestamp`](/api-reference/types/wallet#param-firstseentimestamp) wallet data type
  * Upgraded pump.fun handling after their recent update, also added support for their new "Mayhem" mode
  * Added a requirement for Telegram or Discord connection for account creation (to help facilitate customer communication)
  * Added support for Prop (Dark) AMMs Humidifi and GoonFi (removed from pair trending)
  * Improved calculation formulae for liquidity in Meteora DAMMv2 contracts
  * Excluded all Prop (Dark) AMM pairs from trending
  * Documentation enhancements (improved visibility of input object types available per endpoint with expandable fields rather than separate pages)
  * Big improvements to [`getBars`](/api-reference/queries/getbars) (including sparklines) to run queries \~2x faster
  * Built support for Baseline Markets bSwap protocol
  * Fixed stale usage data issue in the Codex dashboard
  * Fixed [`getTokenPrices`](/api-reference/queries/gettokenprices) latency issues
  * Monad launch-day support — added support for BonadFun, NadFun, Printr, and other protocols
  * Codex docs improvements:
    * Updated styling / better visibility of endpoint object types
    * Added query/response examples
  * SDK updates v1.0.36→v2.0.0:
    * Updated to add Bundlers/Snipers/Insiders data
    * 60% smaller bundle size for end users
    * Better tree-shaking with ESM support, falls back to CommonJS
    * Modern tooling throughout development workflow
    * Removed fragment masking since it's generic and not used in SDK directly
</Update>

<Update label="Oct 2025" description="New dashboard, Monad & Katana support">
  * `tokenId` array added for [`filterTokenWallets`](/api-reference/queries/filtertokenwallets)
  * New Codex API dashboard launched at dashboard.codex.io with improved usage metrics, analytics, and auth pages
  * Added support for DYORPump launchpad protocol
  * Added support for "Four.meme Fair" launchpad, for Fourmeme tokens that are launched on Binance Wallet
  * Added `isDynamicFee` field to indicate whether a UniswapV4 pool uses a dynamic fee or not
  * Added ability in [`getTokenPrices`](/api-reference/queries/gettokenprices) to further break down prices by block in the case of subsecond block time (e.g., BNB chain)
  * Added a flag on pair metadata subscription to automatically pick quoteToken
  * Added `tokenCreatedAt` sorting to [`filterTokens`](/api-reference/queries/filtertokens) query and FE launchpad page
  * Added Katana network support
  * Bug fix: launchpad tokens that graduate/migrate consistently report 100% grad percent
  * Added support for Printr
  * Monad support (went live to all customers at launch)
  * Fixed `exchangeVersion` bug on filter endpoints
  * Added social platform login/authentication for dashboard access
</Update>

<Update label="Sep 2025" description="Token-level bar endpoints, search improvements">
  * [`GetTokenBars`](/api-reference/queries/gettokenbars) deployed as new endpoint — aggregated version of [`getBars`](/api-reference/queries/getbars), consolidating all valid token pairs into one (historical data limited)
  * [`OnTokenBarsUpdated`](/api-reference/subscriptions/ontokenbarsupdated) deployed as an aggregated version of [`onBarsUpdated`](/api-reference/subscriptions/onbarsupdated), using token events across all pools containing the token (historical data limited)
  * Big searching improvements to [`filterTokens`](/api-reference/queries/filtertokens):
    * Lowercase address search
    * Search for address by prefix
    * Ability to match non-alphanumeric characters in token names/symbols
    * General better phrase matching
  * Improved [`filterPairs`](/api-reference/queries/filterpairs) to bring searching in line with [`filterTokens`](/api-reference/queries/filtertokens)
  * Protocols:
    * Added support for Raydium Launchlab initialize\_v2 instruction, and Meteora DBC swap2 instruction
    * Added support for SolFi and TesseraV exchanges
  * Mintable/Freezable authorities for tokens are now appropriately updated. When freezable/mintable is null you can check the new `isValid` field to determine if the null is intentionally set or if the token has not been updated yet
  * Updated `TokenWalletFilterResult` type to include the complete `EnhancedToken` instead of a subset
  * Added `tokenBalanceLive` to [`FilterTokenWallets`](/api-reference/queries/filtertokenwallets) endpoint for more up-to-date balance info
  * Added `isToken0NetworkToken` to `UniswapV4Data` so that consumers can know if they're dealing with the network token (i.e., ETH not WETH)
  * Updated `expiresIn` default to 1 hour for [`CreateApiTokens`](/api-reference/mutations/createapitokens) mutation
  * Fixed filtering bug for [`onEventsCreated`](/api-reference/subscriptions/oneventscreated) — consumers can now use `address` + `networkId` without entitlement error
  * Added support for Somnia and Plasma networks, including Somnia Meme launchpad
  * Weighted pricing with filtering integrated into token aggregates — pricing will no longer use just the top pair:
    * Weighted average based on liquidity/recency, filters out pairs that use swap pricing
  * Removed search tokens endpoint
  * Added network-wide support in [`onTokenBarsUpdated`](/api-reference/subscriptions/ontokenbarsupdated) by publishing only the top bars for each pair
  * SDK updates v1.0.26→v1.0.36:
    * TokenMill V2 Launchpad support
    * `isToken0NetworkToken` to pair protocol data type
    * Override GQL document build for filterTokenWallets
    * Generate latest types
</Update>

<Update label="Aug 2025" description="Heaven AMM, launchpad expansion, liquid pair data">
  * `imageThumbHash` added to `tokenInfo` schema type (new tokens only, not backfilled)
  * Added `liquidPair`, `liquidPairLiquidity`, and `liquidPairPriceUsd` data to [`filterTokens`](/api-reference/queries/filtertokens) — info about the most liquid pair, which is not necessarily the top pair
  * Added `protocols` and `launchpadNames` subscriptions input options
  * Created a wallet backfill mutation for paid users
  * Added support for Baseapp/Zora/Zora Creator on launchpads
  * Added Heaven AMM and launchpad support
  * Improved query performance of [`filterPairs`](/api-reference/queries/filterpairs), `prices`, and [`holders`](/api-reference/queries/holders)
  * Added TokenMill V2 launchpad support
  * Added support for lowercase Solana contract address searching
  * [`onLaunchpadTokenEvents`](/api-reference/subscriptions/onlaunchpadtokenevent) and [`onLaunchpadTokenEventsBatch`](/api-reference/subscriptions/onlaunchpadtokeneventbatch) will now publish updates (`eventType: Updated`) for 6 hours after token migration — no handoff to [`onPairMetadataUpdated`](/api-reference/subscriptions/onpairmetadataupdated) required for migrated tokens
  * Added support for Virtuals and Clanker on launchpads
  * Improved phrase searching on [`filterTokens`](/api-reference/queries/filtertokens) for tokens with a `$` prefix
  * SDK updates v1.0.17→v1.0.26:
    * Added latest schema
    * Added launchpadName to subscription override
    * Allow list input to [`filterTokens`](/api-reference/queries/filtertokens) for `launchpadName` and `launchpadProtocol`
    * Added new launchpad protocols
    * Added generated network configs to list of public endpoints
    * Added Heaven AMM/launchpad support
    * Generated new schema
    * Allow overriding default fetch function
    * Added TokenMill V2 launchpad support
</Update>

<Update label="July 2025" description="Baseapp/Zora support, Uni V4 hooks, SDK v1.0.17">
  * Improved phrase searching on [`filterTokens`](/api-reference/queries/filtertokens) to be more accurate and provide fewer irrelevant results with low liquidity or recent activity
  * Added limit argument for holders query
  * `launchpadName` filter added as subscription input
  * Added `filterWallet` to tracked Wallets endpoint
  * Added support for indexing Uni V4 hook addresses with pairs (added to OpenSearch for filter support)
  * Added support for Baseapp protocol (and Zora) — new token creator metadata and Zora protocol support, including ERC721 metadata for EVM tokens
  * Fixes to Uni V4 price routing
  * Added support for launchpad icons to be stamped on EnhancedTokens
  * SDK updated to v1.0.17. Changes from v1.0.11→v1.0.17:
    * Unconfirmed launchpad events
    * Launchpad event filters
    * Baseapp/Zora launchpad protocol
    * Added liquidity on `LaunchpadTokenEventOutput`
    * Fixed async issue for generated subscriptions
    * Fixed issue where launchpad network filters were showing tokens on unspecified networks
</Update>

<Update label="June 2025" description="Wallet endpoints, Market Cap webhooks, Mintlify docs launch">
  * Wallet Endpoints (Trader Stats) released
  * Events By Maker subscription released
  * Token Liquidity Metadata endpoint released (locked liquidity across top 100 pairs)
  * Market Cap webhooks released
  * Swap percent and wallet ages added to [`filterTokens`](/api-reference/queries/filtertokens)
  * Improved launchpad data and support (websockets, [`filterTokens`](/api-reference/queries/filtertokens) arguments, 11+ launchpads supported and growing)
  * Somnia testnet
  * Added support for Meteora v2 swap events
  * Implemented Hyperfluid V3
  * TokenMill v2 and Heaven AMM protocol support added
  * Taraxa Network support
  * Fixed Raydium Launchlab attributed pair address
  * `walletAddress` input on orders and positions queries
  * Improved Launchpad Protocol name filtering (separated out third-party launchpads such as Bonk and Jupiter)
  * Improved token symbol matching for `phrase` searches using `$` prefix
  * Updated trending status to ignore a pair until it has enough trading data to be relevant
  * Wallet ages added for Sui & Starknet
  * Added Arena.Trade launchpad support
  * Docs migration to Mintlify (docs.codex.io)
</Update>

<Update label="May 2025" description="Launchpad event batch, SDK v1.0.7, Meteora DAMM v2">
  * Added [`LaunchpadTokenEventBatch`](/api-reference/subscriptions/onlaunchpadtokeneventbatch) subscription — publishes a batch of updates at once instead of each one individually
  * `walletAge` property added to token events (for both subscriptions and [`getTokenEvents`](/api-reference/queries/gettokenevents) endpoint)
  * Fixed issue with `quoteTokens` on events showing incorrect prices
  * Added Yominet network support
  * SDK v1.0.7 released
  * Launchpad events added for moon.it, bonkFun, boopFun, and Meteora DBC
  * Added buy/sell volume filters to [`filterTokens`](/api-reference/queries/filtertokens)/[`filterPairs`](/api-reference/queries/filterpairs)
  * Fixed a bug where free account usage failed to reset
  * Added Vertigo and EgoTech launchpad support
  * Meteora DAMM v2 support added
</Update>

<Update label="April 2025" description="FourMeme + Raydium LaunchLab, MCP server, SDK v1.0.6">
  * BSC/FourMeme and Raydium LaunchLab support for launchpad events added to [`onLaunchpadTokenEvent`](/api-reference/subscriptions/onlaunchpadtokenevent)
  * Bonk.Fun tokens supported from launch as they utilize Raydium LaunchLab
  * SDK v1.0.6 released
  * Codex MCP server released
  * Added support for Curve's TwoCrypto protocol
  * Added support for Over Protocol
  * Added indexing for Raydium LaunchLab tokens
  * Added support for iZiSwap (Izumi Finance)
  * Improvements for scam detection using wallet age metrics
  * Added network array to [`balances`](/api-reference/queries/balances) endpoint queries
  * Implemented Rainbow launchpad support and accompanying new `launchpadProtocol` field on enhanced tokens
  * Support for Rainbow and Moon.it launchpad metadata
  * Added and released Zora network
  * Added support for Starknet charts and events
  * Fixed FourMeme graduation support for Pancake V2 migrations
</Update>

<Update label="March 2025" description="pump.fun AMM, Aptos network, launchpad websocket">
  * Support added for pump.fun AMM
  * Camelot & StellaSwap fully supported on Integral 1.2
  * FluxBeam protocol indexing (as of March 10th)
  * Bunni protocol indexing
  * Added entitlements system to permit pay-to-access for certain features such as network-wide subscriptions and wallet stats/filtering
  * [`onLaunchpadTokenEvents`](/api-reference/subscriptions/onlaunchpadtokenevent) websocket released
  * [`tokenTopTraders`](/api-reference/queries/tokentoptraders) endpoint released
  * Aptos network support:
    * Added Emojicoin, Liquidswap, Hyperfluid, Thala, and Cellana protocols
  * FAQ page added to documentation
  * Added network-wide support in [`onTokenBarsUpdated`](/api-reference/subscriptions/ontokenbarsupdated) by publishing only the top bars for each pair
  * 5min trending scores added to filter tokens/pairs
  * Volume change added to network stats
</Update>

<Update label="February 2025" description="Berachain, Sui, Unichain & Sophon network support">
  * Berachain indexing
  * Added Sui network
  * Unichain support (with Uni V4)
  * Sophon network support
  * four.meme support
  * Codex SDK updated to v1.0.5
  * 5min data added to [`filterTokens`](/api-reference/queries/filtertokens), [`pairMetadata`](/api-reference/queries/pairmetadata), and [`onPairMetadataUpdated`](/api-reference/subscriptions/onpairmetadataupdated)
  * Major updates to explorer.codex.io (including saved state, tabbed view)
</Update>

<Update label="January 2025" description="Uniswap V4 indexing, Abstract Chain, new wallet endpoints">
  * Added Maverick Protocol
  * Added Swell network
  * Added Ronin & Saigon testnet networks
  * `enhancedToken0` and `enhancedToken1` fields added
  * `MakersEventQueryInput` modified with optional fields (`timestamp`, `priceUsdTotal`, `eventType`, `tokenAddress`)
  * `LaunchPadTokenUpdate` endpoint added to replace `TokenUpdate`
  * `NotableHolders` endpoints added
  * [`TokenEventsForMaker`](/api-reference/queries/gettokeneventsformaker) endpoint added
  * Uniswap V4 data indexing
  * Abstract Chain indexing
</Update>

<Update label="December 2024" description="Unconfirmed aggregates, SDK v1.0, Sonic network">
  * Added unconfirmed aggregates/[`onUnconfirmedBarsUpdated`](/api-reference/subscriptions/onunconfirmedbarsupdated)
  * Added `poolAddress` to the [`getTokenPrices`](/api-reference/queries/gettokenprices) endpoint so that you can specify a pool
  * Shipped version 1.0.0 of the SDK with enhanced query/mutation/subscription support
  * Implemented filter orders by token address
  * Added Sonic network
  * Fixed an issue with retrieving exchanges within [`filterTokens`](/api-reference/queries/filtertokens)
</Update>

<Update label="November 2024" description="Unconfirmed event pricing, token bar subscriptions by ID">
  * Exposed pricing data on the unconfirmed events for public use
  * New [`onTokenBarUpdate`](/api-reference/subscriptions/ontokenbarsupdated) subscription that allows subscriptions using token IDs
  * Added support for daos.fun protocol
  * Built AnimalFactory support
</Update>

<Update label="October 2024" description="Unconfirmed Solana events, wallet tracking, World Chain support">
  * Added [`onPricesUpdated`](/api-reference/subscriptions/onpricesupdated) endpoint to publish price changes for multiple tokens
  * Added [`onUnconfirmedEventsCreated`](/api-reference/subscriptions/onunconfirmedeventscreated) endpoint to publish unconfirmed events for Solana
  * Added wallet tracking
  * Added support for Chiliz and World Chain networks
  * Fixed address casing issues in subscription endpoints — now they can handle cased and uncased formats
  * Added support for Velodrome v3 protocol
</Update>

<Update label="Sept 30, 2024" description="Bug fix: getTokensInfo partial results">
  * Fixed bug that was preventing `getTokensInfo` from returning partial results
</Update>

<Update label="Aug 26, 2024" description="Bitbond liquidity protocol support">
  * Added Bitbond to liquidity supported protocols
</Update>
