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

# Direct API: Codex

> API endpoints for Codex.

# 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](https://docs.codex.io/reference)

## 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:**

```bash theme={null}
curl --request POST \
  --url https://api.uniblock.dev/direct/v1/Codex/filterNftPoolCollections \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```

## DeFi

### POST

| Path                                                                                                                           | Est. CU | Description                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------ | ------: | --------------------------------------------------------------------------------------- |
| [direct/v1/Codex/filterNftPoolCollections](https://docs.codex.io/reference/filternftpoolcollections)                           |    3500 | Returns a list of NFT collections based on a variety of filters.                        |
| [direct/v1/Codex/filterNftPools](https://docs.codex.io/reference/filternftpools)                                               |    3500 | Returns a list of NFT pools based on a variety of filters.                              |
| [direct/v1/Codex/getDetailedPairsStats](https://docs.codex.io/reference/getdetailedpairsstats)                                 |    3500 | Returns bucketed stats for a given token within a list of pairs.                        |
| [direct/v1/Codex/getDetailedPairStats](https://docs.codex.io/reference/getdetailedpairstats)                                   |    3500 | Returns bucketed stats for a given token within a pair.                                 |
| [direct/v1/Codex/getDetailedStats](https://docs.codex.io/reference/getdetailedstats)                                           |    3500 | Returns bucketed stats for a given token within a pair.                                 |
| [direct/v1/Codex/getExchanges](https://docs.codex.io/reference/getexchanges)                                                   |    3500 | Returns a list of decentralized exchange metadata.                                      |
| [direct/v1/Codex/getLatestPairs](https://docs.codex.io/reference/getlatestpairs)                                               |    3500 | Returns new tokens listed over the last three days.                                     |
| [direct/v1/Codex/getNftPool](https://docs.codex.io/reference/getnftpool)                                                       |    3500 | Returns an NFT pool.                                                                    |
| [direct/v1/Codex/getNftPoolCollection](https://docs.codex.io/reference/getnftpoolcollection)                                   |    3500 | Returns an NFT pool collection with pool stats for a given AMM NFT marketplace.         |
| [direct/v1/Codex/getNftPoolCollectionsByExchange](https://docs.codex.io/reference/getnftpoolcollectionsbyexchange)             |    3500 | Returns an NFT collection with pool stats for a given AMM NFT marketplace.              |
| [direct/v1/Codex/getNftPoolEvents](https://docs.codex.io/reference/getnftpoolevents)                                           |    3500 | Returns transactions for an NFT collection across all NFT pools or within a given pool. |
| [direct/v1/Codex<br />/getNftPoolsByCollectionAndExchange](https://docs.codex.io/reference/getnftpoolsbycollectionandexchange) |    3500 | Returns NFT pools for a given collection and AMM NFT marketplace.                       |
| [direct/v1/Codex/getNftPoolsByOwner](https://docs.codex.io/reference/getnftpoolsbyowner)                                       |    3500 | Returns a list of NFT pools for a given owner.                                          |
| [direct/v1/Codex/getNftPoolStats](https://docs.codex.io/reference/getnftpoolstats)                                             |    3500 | Returns aggregated NFT pool/collection stats for a given time frame.                    |
| [direct/v1/Codex/getPrimePoolAssets](https://docs.codex.io/reference/getprimepoolassets)                                       |    3500 | Returns a list of Prime pool cached assets.                                             |
| [direct/v1/Codex/getPrimePoolEvents](https://docs.codex.io/reference/getprimepoolevents)                                       |    3500 | Returns a list of Prime pool events.                                                    |
| [direct/v1/Codex/getPrimePools](https://docs.codex.io/reference/getprimepools)                                                 |    3500 | Returns a list of Prime pools.                                                          |
| [direct/v1/Codex/getUniV3Ticks](https://docs.codex.io/reference/getuniv3ticks)                                                 |    3500 | Returns tick data for a given Uniswap V3-style pool.                                    |
| [direct/v1/Codex/pairMetadata](https://docs.codex.io/reference/pairmetadata)                                                   |    3500 | Returns metadata for a pair of tokens.                                                  |
| [direct/v1/Codex/primeHolders](https://docs.codex.io/reference/primeholders)                                                   |    3500 | Returns a list of holders of the PRIME token on ethereum.                               |

## Market Data

### POST

| Path                                                                                 | Est. CU | Description                                                                      |
| ------------------------------------------------------------------------------------ | ------: | -------------------------------------------------------------------------------- |
| [direct/v1/Codex/filterExchanges](https://docs.codex.io/reference/filterexchanges)   |    3500 | Returns a list of exchanges based on a variety of filters.                       |
| [direct/v1/Codex/filterPairs](https://docs.codex.io/reference/filterpairs)           |    3500 | Returns a list of pairs based on a variety of filters.                           |
| [direct/v1/Codex/getBars](https://docs.codex.io/reference/getbars)                   |    3500 | Returns bar chart data to track price changes over time.                         |
| [direct/v1/Codex/getDetailedStats](https://docs.codex.io/reference/getdetailedstats) |    3500 | Returns bucketed stats for a given token within a pair.                          |
| [direct/v1/Codex/getTokenPrices](https://docs.codex.io/reference/gettokenprices)     |    3500 | Returns real-time or historical prices for a list of tokens, fetched in batches. |
| [direct/v1/Codex/tokenSparklines](https://docs.codex.io/reference/tokensparklines)   |    3500 | Returns a list of token simple chart data (sparklines) for the given tokens.     |

## NFT

### POST

| Path                                                                                                                           | Est. CU | Description                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------------------ | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Codex/filterNftCollections](https://docs.codex.io/reference/filternftcollections)                                   |    3500 | Returns a list of NFT collection based on a variety of filters.                                                                                |
| [direct/v1/Codex/filterNftParallelAssets](https://docs.codex.io/reference/filternftparallelassets)                             |    3500 | Returns a list of Parallel assets based on a variety of filters.                                                                               |
| [direct/v1/Codex/filterNftPoolCollections](https://docs.codex.io/reference/filternftpoolcollections)                           |    3500 | Returns a list of NFT collections based on a variety of filters.                                                                               |
| [direct/v1/Codex/filterNftPools](https://docs.codex.io/reference/filternftpools)                                               |    3500 | Returns a list of NFT pools based on a variety of filters.                                                                                     |
| [direct/v1/Codex/getDetailedNftStats](https://docs.codex.io/reference/getdetailednftstats)                                     |    3500 | Returns bucketed stats for a given NFT collection.                                                                                             |
| [direct/v1/Codex/getNftAssets](https://docs.codex.io/reference/getnftassets)                                                   |    3500 | Returns a list of NFT assets in a given collection.                                                                                            |
| [direct/v1/Codex/getNftCollectionMetadata](https://docs.codex.io/reference/getnftcollectionmetadata)                           |    3500 | Returns stats for an NFT collection across different time frames.                                                                              |
| [direct/v1/Codex/getNftContracts](https://docs.codex.io/reference/getnftcontracts)                                             |    3500 | Returns a list of NFT collection metadata.                                                                                                     |
| [direct/v1/Codex/getNftEvents](https://docs.codex.io/reference/getnftevents)                                                   |    3500 | Returns transactions for an NFT collection across any marketplace(s).                                                                          |
| [direct/v1/Codex/getNftPool](https://docs.codex.io/reference/getnftpool)                                                       |    3500 | Returns an NFT pool.                                                                                                                           |
| [direct/v1/Codex/getNftPoolCollection](https://docs.codex.io/reference/getnftpoolcollection)                                   |    3500 | Returns an NFT pool collection with pool stats for a given AMM NFT marketplace.                                                                |
| [direct/v1/Codex/getNftPoolCollectionsByExchange](https://docs.codex.io/reference/getnftpoolcollectionsbyexchange)             |    3500 | Returns an NFT collection with pool stats for a given AMM NFT marketplace.                                                                     |
| [direct/v1/Codex/getNftPoolEvents](https://docs.codex.io/reference/getnftpoolevents)                                           |    3500 | Returns transactions for an NFT collection across all NFT pools or within a given pool.                                                        |
| [direct/v1/Codex<br />/getNftPoolsByCollectionAndExchange](https://docs.codex.io/reference/getnftpoolsbycollectionandexchange) |    3500 | Returns NFT pools for a given collection and AMM NFT marketplace.                                                                              |
| [direct/v1/Codex/getNftPoolsByOwner](https://docs.codex.io/reference/getnftpoolsbyowner)                                       |    3500 | Returns a list of NFT pools for a given owner.                                                                                                 |
| [direct/v1/Codex/getNftPoolStats](https://docs.codex.io/reference/getnftpoolstats)                                             |    3500 | Returns aggregated NFT pool/collection stats for a given time frame.                                                                           |
| [direct/v1/Codex/getParallelAssets](https://docs.codex.io/reference/getparallelassets)                                         |    3500 | Returns transactions for an NFT collection across any marketplace(s).                                                                          |
| [direct/v1/Codex/getParallelCardChanges](https://docs.codex.io/reference/getparallelcardchanges)                               |    3500 | Returns changes made to Parallel card metadata over time.                                                                                      |
| [direct/v1/Codex/nftHolders](https://docs.codex.io/reference/nftholders)                                                       |    3500 | 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](https://docs.codex.io/reference/searchnfts)                                                       |    3500 | Returns a list of NFT collections matching a given query string.                                                                               |
| [direct/v1/Codex/walletNftCollectionAssets](https://docs.codex.io/reference/walletnftcollectionassets)                         |    3500 | Returns list of NFT assets held by a given wallet for a single collection.                                                                     |
| [direct/v1/Codex/walletNftCollections](https://docs.codex.io/reference/walletnftcollections)                                   |    3500 | Returns list of collections and quantity of NFTs held by a given wallet.                                                                       |

## Token

### POST

| Path                                                                                                            | Est. CU | Description                                                                                                                          |
| --------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------------------------------------------------------ |
| [direct/v1/Codex/balances](https://docs.codex.io/reference/balances)                                            |    3500 | Returns list of token balances that a wallet has                                                                                     |
| [direct/v1/Codex/chartUrls](https://docs.codex.io/reference/charturls)                                          |    3500 | Returns a URL for a pair chart.                                                                                                      |
| [direct/v1/Codex/filterTokens](https://docs.codex.io/reference/filtertokens)                                    |    3500 | Returns a list of tokens based on a variety of filters.                                                                              |
| [direct/v1/Codex/getBars](https://docs.codex.io/reference/getbars)                                              |    3500 | Returns bar chart data to track price changes over time.                                                                             |
| [direct/v1/Codex/getCommunityNotes](https://docs.codex.io/reference/getcommunitynotes)                          |    3500 | Returns community gathered notes.                                                                                                    |
| [direct/v1/Codex/getDetailedStats](https://docs.codex.io/reference/getdetailedstats)                            |    3500 | Returns bucketed stats for a given token within a pair.                                                                              |
| [direct/v1/Codex/getLatestTokens](https://docs.codex.io/reference/getlatesttokens)                              |    3500 | Returns new tokens listed over the last three days.                                                                                  |
| [direct/v1/Codex/getNetworks](https://docs.codex.io/reference/getnetworks)                                      |    3500 | Returns a list of all networks supported on Codex.                                                                                   |
| [direct/v1/Codex/getNetworkStatus](https://docs.codex.io/reference/getnetworkstatus)                            |    3500 | Returns the status of a list of networks supported on Codex.                                                                         |
| [direct/v1/Codex/getSimulateTokenContractResults](https://docs.codex.io/reference/simulatetokencontractresults) |    3500 | Simulates a token contract call.                                                                                                     |
| [direct/v1/Codex/getSymbol](https://docs.codex.io/reference/getsymbol)                                          |    3500 | Returns metadata for a given pair.                                                                                                   |
| [direct/v1/Codex/getTokenCount](https://docs.codex.io/reference/gettokencount)                                  |    3500 | Returns the total count of tokens on Codex. This value is updated approximately every 6 hours.                                       |
| [direct/v1/Codex/getTokenEvents](https://docs.codex.io/reference/gettokenevents)                                |    3500 | Returns transactions for a pair.                                                                                                     |
| [direct/v1/Codex/getTokenInfo](https://docs.codex.io/reference/gettokeninfo)                                    |    3500 | Returns metadata for a given token.                                                                                                  |
| [direct/v1/Codex/getTokenPrices](https://docs.codex.io/reference/gettokenprices)                                |    3500 | Returns real-time or historical prices for a list of tokens, fetched in batches.                                                     |
| [direct/v1/Codex/getTokensInfo](https://docs.codex.io/reference/gettokensinfo)                                  |    3500 | Returns metadata for a list of given tokens.                                                                                         |
| [direct/v1/Codex/holders](https://docs.codex.io/reference/holders)                                              |    3500 | 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](https://docs.codex.io/reference/listfavoritetokens)                        |    3500 | Returns a list of token metadata.                                                                                                    |
| [direct/v1/Codex/listPairsForToken](https://docs.codex.io/reference/listpairsfortoken)                          |    3500 | Returns a list of pairs containing a given token.                                                                                    |
| [direct/v1/Codex/listPairsWithMetadataForToken](https://docs.codex.io/reference/listpairswithmetadatafortoken)  |    3500 | Returns a list of pair metadata for a token.                                                                                         |
| [direct/v1/Codex/listTopTokens](https://docs.codex.io/reference/listtoptokens)                                  |    3500 | Returns a list of trending tokens across any given network(s).                                                                       |
| [direct/v1/Codex/searchTokens](https://docs.codex.io/reference/searchtokens)                                    |    3500 | Returns a list of tokens matching a given query string.                                                                              |
| [direct/v1/Codex/token](https://docs.codex.io/reference/token)                                                  |    3500 | Find a single token by its address & network id.                                                                                     |
| [direct/v1/Codex/tokens](https://docs.codex.io/reference/tokens)                                                |    3500 | Find a list of tokens by their addresses & network id, with pagination.                                                              |
| [direct/v1/Codex/tokenSparklines](https://docs.codex.io/reference/tokensparklines)                              |    3500 | Returns a list of token simple chart data (sparklines) for the given tokens.                                                         |

## Transaction

### POST

| Path                                                                             | Est. CU | Description                                |
| -------------------------------------------------------------------------------- | ------: | ------------------------------------------ |
| [direct/v1/Codex/getEventLabels](https://docs.codex.io/reference/geteventlabels) |    3500 | Returns a list of event labels for a pair. |

## Wallets

### POST

| Path                                                                                                   | Est. CU | Description                                                                |
| ------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------------------------------------------- |
| [direct/v1/Codex/balances](https://docs.codex.io/reference/balances)                                   |    3500 | Returns list of token balances that a wallet has                           |
| [direct/v1/Codex/primeBalance](https://docs.codex.io/reference/primebalance)                           |    3500 | Fetch the balance of a wallet holding PRIME on ethereum                    |
| [direct/v1/Codex/walletNftCollectionAssets](https://docs.codex.io/reference/walletnftcollectionassets) |    3500 | Returns list of NFT assets held by a given wallet for a single collection. |
| [direct/v1/Codex/walletNftCollections](https://docs.codex.io/reference/walletnftcollections)           |    3500 | Returns list of collections and quantity of NFTs held by a given wallet.   |
