Codex: Direct API Endpoints

Codex provides 61 unique direct API endpoints across the following categories:

DeFi (20 endpoints)
Market Data (6 endpoints)
NFT (22 endpoints)
Token (25 endpoints)
Transaction (1 endpoint)
Wallets (4 endpoints)

Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.

Learn more: Codex Documentation

Prefix and Example

Prefix: No prefix is required for Codex, an example URL will therefore look like: https://api.uniblock.dev/direct/v1/Codex + /[Codex_endpoint]. Example Request:

curl --request POST \
  --url https://api.uniblock.dev/direct/v1/Codex/filterNftPoolCollections \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_UNIBLOCK_API_KEY'

Request format: GraphQL over POST

Codex’s underlying API is GraphQL. Uniblock exposes each Codex query as a REST-style POST endpoint whose path segment matches the Codex operation name exactly. For example, batch pricing is direct/v1/Codex/getTokenPrices, not tokenPrices. Use the paths listed in the tables below. Every Codex endpoint accepts a standard GraphQL HTTP body with two fields:

query: the GraphQL document as a string, using the arguments and fields from the linked Codex reference page
variables: an object with values for any variables in the query (use {} if there are none)

Example: Look up a single token with direct/v1/Codex/token, which takes an input object of address and networkId:

curl --request POST \
  --url https://api.uniblock.dev/direct/v1/Codex/token \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_UNIBLOCK_API_KEY' \
  --data '{
    "query": "{ token(input: { address: \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\", networkId: 1 }) { id address networkId name symbol decimals isScam } }",
    "variables": {}
  }'

Authenticate with your Uniblock API key in the x-api-key header. You do not need a Codex API key. The full schema for each query (arguments, response fields, network IDs) is documented on the linked Codex reference pages.

DeFi

POST

Path	Est. CU	Description
direct/v1/Codex/filterNftPoolCollections	100	Returns a list of NFT collections based on a variety of filters.
direct/v1/Codex/filterNftPools	100	Returns a list of NFT pools based on a variety of filters.
direct/v1/Codex/getDetailedPairsStats	100	Returns bucketed stats for a given token within a list of pairs.
direct/v1/Codex/getDetailedPairStats	100	Returns bucketed stats for a given token within a pair.
direct/v1/Codex/getDetailedStats	100	Returns bucketed stats for a given token within a pair.
direct/v1/Codex/getExchanges	100	Returns a list of decentralized exchange metadata.
direct/v1/Codex/getLatestPairs	100	Returns new tokens listed over the last three days.
direct/v1/Codex/getNftPool	100	Returns an NFT pool.
direct/v1/Codex/getNftPoolCollection	100	Returns an NFT pool collection with pool stats for a given AMM NFT marketplace.
direct/v1/Codex/getNftPoolCollectionsByExchange	100	Returns an NFT collection with pool stats for a given AMM NFT marketplace.
direct/v1/Codex/getNftPoolEvents	100	Returns transactions for an NFT collection across all NFT pools or within a given pool.
direct/v1/Codex /getNftPoolsByCollectionAndExchange	100	Returns NFT pools for a given collection and AMM NFT marketplace.
direct/v1/Codex/getNftPoolsByOwner	100	Returns a list of NFT pools for a given owner.
direct/v1/Codex/getNftPoolStats	100	Returns aggregated NFT pool/collection stats for a given time frame.
direct/v1/Codex/getPrimePoolAssets	100	Returns a list of Prime pool cached assets.
direct/v1/Codex/getPrimePoolEvents	100	Returns a list of Prime pool events.
direct/v1/Codex/getPrimePools	100	Returns a list of Prime pools.
direct/v1/Codex/getUniV3Ticks	100	Returns tick data for a given Uniswap V3-style pool.
direct/v1/Codex/pairMetadata	100	Returns metadata for a pair of tokens.
direct/v1/Codex/primeHolders	100	Returns a list of holders of the PRIME token on ethereum.

Market Data

POST

Path	Est. CU	Description
direct/v1/Codex/filterExchanges	100	Returns a list of exchanges based on a variety of filters.
direct/v1/Codex/filterPairs	100	Returns a list of pairs based on a variety of filters.
direct/v1/Codex/getBars	100	Returns bar chart data to track price changes over time.
direct/v1/Codex/getDetailedStats	100	Returns bucketed stats for a given token within a pair.
direct/v1/Codex/getTokenPrices	100	Returns real-time or historical prices for a list of tokens, fetched in batches.
direct/v1/Codex/tokenSparklines	100	Returns a list of token simple chart data (sparklines) for the given tokens.

NFT

POST

Path	Est. CU	Description
direct/v1/Codex/filterNftCollections	100	Returns a list of NFT collection based on a variety of filters.
direct/v1/Codex/filterNftParallelAssets	100	Returns a list of Parallel assets based on a variety of filters.
direct/v1/Codex/filterNftPoolCollections	100	Returns a list of NFT collections based on a variety of filters.
direct/v1/Codex/filterNftPools	100	Returns a list of NFT pools based on a variety of filters.
direct/v1/Codex/getDetailedNftStats	100	Returns bucketed stats for a given NFT collection.
direct/v1/Codex/getNftAssets	100	Returns a list of NFT assets in a given collection.
direct/v1/Codex/getNftCollectionMetadata	100	Returns stats for an NFT collection across different time frames.
direct/v1/Codex/getNftContracts	100	Returns a list of NFT collection metadata.
direct/v1/Codex/getNftEvents	100	Returns transactions for an NFT collection across any marketplace(s).
direct/v1/Codex/getNftPool	100	Returns an NFT pool.
direct/v1/Codex/getNftPoolCollection	100	Returns an NFT pool collection with pool stats for a given AMM NFT marketplace.
direct/v1/Codex/getNftPoolCollectionsByExchange	100	Returns an NFT collection with pool stats for a given AMM NFT marketplace.
direct/v1/Codex/getNftPoolEvents	100	Returns transactions for an NFT collection across all NFT pools or within a given pool.
direct/v1/Codex /getNftPoolsByCollectionAndExchange	100	Returns NFT pools for a given collection and AMM NFT marketplace.
direct/v1/Codex/getNftPoolsByOwner	100	Returns a list of NFT pools for a given owner.
direct/v1/Codex/getNftPoolStats	100	Returns aggregated NFT pool/collection stats for a given time frame.
direct/v1/Codex/getParallelAssets	100	Returns transactions for an NFT collection across any marketplace(s).
direct/v1/Codex/getParallelCardChanges	100	Returns changes made to Parallel card metadata over time.
direct/v1/Codex/nftHolders	100	Returns list of wallets that hold a given collection, ordered by holdings descending. Also has the unique count of holders for that collection
direct/v1/Codex/searchNfts	100	Returns a list of NFT collections matching a given query string.
direct/v1/Codex/walletNftCollectionAssets	100	Returns list of NFT assets held by a given wallet for a single collection.
direct/v1/Codex/walletNftCollections	100	Returns list of collections and quantity of NFTs held by a given wallet.

Token

POST

Path	Est. CU	Description
direct/v1/Codex/balances	100	Returns list of token balances that a wallet has
direct/v1/Codex/chartUrls	100	Returns a URL for a pair chart.
direct/v1/Codex/filterTokens	100	Returns a list of tokens based on a variety of filters.
direct/v1/Codex/getBars	100	Returns bar chart data to track price changes over time.
direct/v1/Codex/getCommunityNotes	100	Returns community gathered notes.
direct/v1/Codex/getDetailedStats	100	Returns bucketed stats for a given token within a pair.
direct/v1/Codex/getLatestTokens	100	Returns new tokens listed over the last three days.
direct/v1/Codex/getNetworks	100	Returns a list of all networks supported on Codex.
direct/v1/Codex/getNetworkStatus	100	Returns the status of a list of networks supported on Codex.
direct/v1/Codex/getSimulateTokenContractResults	100	Simulates a token contract call.
direct/v1/Codex/getSymbol	100	Returns metadata for a given pair.
direct/v1/Codex/getTokenCount	100	Returns the total count of tokens on Codex. This value is updated approximately every 6 hours.
direct/v1/Codex/getTokenEvents	100	Returns transactions for a pair.
direct/v1/Codex/getTokenInfo	100	Returns metadata for a given token.
direct/v1/Codex/getTokenPrices	100	Returns real-time or historical prices for a list of tokens, fetched in batches.
direct/v1/Codex/getTokensInfo	100	Returns metadata for a list of given tokens.
direct/v1/Codex/holders	100	Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token
direct/v1/Codex/listFavoriteTokens	100	Returns a list of token metadata.
direct/v1/Codex/listPairsForToken	100	Returns a list of pairs containing a given token.
direct/v1/Codex/listPairsWithMetadataForToken	100	Returns a list of pair metadata for a token.
direct/v1/Codex/listTopTokens	100	Returns a list of trending tokens across any given network(s).
direct/v1/Codex/searchTokens	100	Returns a list of tokens matching a given query string.
direct/v1/Codex/token	100	Find a single token by its address & network id.
direct/v1/Codex/tokens	100	Find a list of tokens by their addresses & network id, with pagination.
direct/v1/Codex/tokenSparklines	100	Returns a list of token simple chart data (sparklines) for the given tokens.

Transaction

POST

Path	Est. CU	Description
direct/v1/Codex/getEventLabels	100	Returns a list of event labels for a pair.

Wallets

POST

Path	Est. CU	Description
direct/v1/Codex/balances	100	Returns list of token balances that a wallet has
direct/v1/Codex/primeBalance	100	Fetch the balance of a wallet holding PRIME on ethereum
direct/v1/Codex/walletNftCollectionAssets	100	Returns list of NFT assets held by a given wallet for a single collection.
direct/v1/Codex/walletNftCollections	100	Returns list of collections and quantity of NFTs held by a given wallet.

Direct APIs

Codex direct API on Uniblock: tokens, NFTs, and market data

Codex: Direct API Endpoints

Prefix and Example

Request format: GraphQL over POST

DeFi

POST

Market Data

POST

NFT

POST

Token

POST

Transaction

POST

Wallets

POST

​Codex: Direct API Endpoints

​Prefix and Example

​Request format: GraphQL over POST

​DeFi

​POST

​Market Data

​POST

​NFT

​POST

​Token

​POST

​Transaction

​POST

​Wallets

​POST

Codex: Direct API Endpoints

Prefix and Example

Request format: GraphQL over POST

DeFi

POST

Market Data

POST

NFT

POST

Token

POST

Transaction

POST

Wallets

POST