Skip to main content

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.

You can subscribe to the RSS changelog at /changelog/rss.xml to stay on top of any weekly updates.
​
May 25, 2026
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 for the verification flow, a Node example, and raw-body capture notes for common frameworks.
  • Kalshi support for live order books. 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 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.
​
May 18, 2026
Sports metadata on prediction events and markets, identityLabels on wallets, optional firehose for onPredictionTradesCreated
  • Sports metadata on prediction events and markets. PredictionEvent and PredictionMarket now expose an enrichedMetadata field returning PredictionEventEnrichedMetadata and 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 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. 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.
​
May 11, 2026
predictionOutcomeOrderBooks, token ATH/ATL data, Polymarket order book fields, Meteora Alpha Vault
  • 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 and PredictionOrderBookLevel types accompany it.
  • All-time high and low data added to tokens. EnhancedToken now exposes an extrema field returning a new 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, 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. 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 and to launchpad event subscriptions.
​
May 4, 2026
eventScopedFilterPredictionMarkets, token boolean filters, Eitherway launchpad
  • 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 when you need entrant/segment/ladder details without re-parsing subtype slugs client-side.
  • Boolean filter composition added to 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 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 and to launchpad event subscriptions.
​
Apr 27, 2026
Polymarket wallet profiles, venue-reported prediction market volume
  • Polymarket profile data added to wallets. The Wallet type now exposes a polymarket field returning a new 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 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.
​
Apr 20, 2026
commitment-level streaming, walletLabelTypes, launchpad fee breakdown, The Grid integration
  • 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, onEventsCreated, and onEventsCreatedByMaker now accept a commitmentLevel argument (Processed, Confirmed), and streamed payloads expose a matching commitmentLevel field. The standalone onUnconfirmedBarsUpdated, onUnconfirmedEventsCreated, and onUnconfirmedEventsCreatedByMaker subscriptions are now deprecated.
  • getLatestPairs and onLatestPairUpdated removed. Both were previously deprecated — use filterPairs sorted by createdAt DESC instead.
  • Fee breakdown added to launchpad token events. 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 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 now accepts hasTwitter, hasDiscord, hasTelegram, hasFarcaster, hasGithub, hasDisplayName, and hasSocials filters, and ethosScore is available as a ranking attribute.
  • Token profanity flag added. 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 and to launchpad event subscriptions; LaunchpadData now exposes category, the launchpad-assigned token category returned by Scale and Creator launchpads.
  • The Grid integration. Token and organization metadata on filterTokens, token, and tokens is now enriched by The Grid, 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.
​
Apr 10, 2026
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 subscription added. Live-streams updates to the current filterTokens result set — requires useAggregatedStats: true.
​
Mar 2026
Prediction markets, getDetailedTokenStats, useAggregatedStats
​
Feb 2026
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 support for ‘Bonkers’ mode tokens from Bonk.fun
  • Added support for the bankr launchpad
  • Fixed a bug with 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
​
Jan 2026
Fogo mainnet, maker attribution, Meteora DAMMv2 locks
  • Fogo mainnet support added (Network ID: 150601)
  • Meteora DAMMv2 liquidity lock tracking
  • Historical bar fetching for 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)
​
Dec 2025
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
​
Nov 2025
Bundlers/snipers/insiders data, pump.fun Mayhem, SDK 2.0
  • Bundlers/Snipers/Insiders data types added to filterTokens and both launchpad event subscriptions — not backfilled
  • Added 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 (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 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
​
Oct 2025
New dashboard, Monad & Katana support
  • tokenId array added for 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 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 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
​
Sep 2025
Token-level bar endpoints, search improvements
  • GetTokenBars deployed as new endpoint — aggregated version of getBars, consolidating all valid token pairs into one (historical data limited)
  • OnTokenBarsUpdated deployed as an aggregated version of onBarsUpdated, using token events across all pools containing the token (historical data limited)
  • Big searching improvements to 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 to bring searching in line with 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 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 mutation
  • Fixed filtering bug for 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 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
​
Aug 2025
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 — 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, prices, and holders
  • Added TokenMill V2 launchpad support
  • Added support for lowercase Solana contract address searching
  • onLaunchpadTokenEvents and onLaunchpadTokenEventsBatch will now publish updates (eventType: Updated) for 6 hours after token migration — no handoff to onPairMetadataUpdated required for migrated tokens
  • Added support for Virtuals and Clanker on launchpads
  • Improved phrase searching on 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 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
​
July 2025
Baseapp/Zora support, Uni V4 hooks, SDK v1.0.17
  • Improved phrase searching on 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
​
June 2025
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
  • Improved launchpad data and support (websockets, 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)
​
May 2025
Launchpad event batch, SDK v1.0.7, Meteora DAMM v2
  • Added LaunchpadTokenEventBatch subscription — publishes a batch of updates at once instead of each one individually
  • walletAge property added to token events (for both subscriptions and 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/filterPairs
  • Fixed a bug where free account usage failed to reset
  • Added Vertigo and EgoTech launchpad support
  • Meteora DAMM v2 support added
​
April 2025
FourMeme + Raydium LaunchLab, MCP server, SDK v1.0.6
  • BSC/FourMeme and Raydium LaunchLab support for launchpad events added to 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 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
​
March 2025
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 websocket released
  • 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 by publishing only the top bars for each pair
  • 5min trending scores added to filter tokens/pairs
  • Volume change added to network stats
​
February 2025
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, pairMetadata, and onPairMetadataUpdated
  • Major updates to explorer.codex.io (including saved state, tabbed view)
​
January 2025
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 endpoint added
  • Uniswap V4 data indexing
  • Abstract Chain indexing
​
December 2024
Unconfirmed aggregates, SDK v1.0, Sonic network
  • Added unconfirmed aggregates/onUnconfirmedBarsUpdated
  • Added poolAddress to the 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
​
November 2024
Unconfirmed event pricing, token bar subscriptions by ID
  • Exposed pricing data on the unconfirmed events for public use
  • New onTokenBarUpdate subscription that allows subscriptions using token IDs
  • Added support for daos.fun protocol
  • Built AnimalFactory support
​
October 2024
Unconfirmed Solana events, wallet tracking, World Chain support
  • Added onPricesUpdated endpoint to publish price changes for multiple tokens
  • Added 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
​
Sept 30, 2024
Bug fix: getTokensInfo partial results
  • Fixed bug that was preventing getTokensInfo from returning partial results
​
Aug 26, 2024
Bitbond liquidity protocol support
  • Added Bitbond to liquidity supported protocols