> ## 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.

# filterNetworks

> Returns a list of networks based on a variety of filters. Reference for the filterNetworks query in the Codex API: arguments, response fields, and usage.

`filterNetworks` returns network-level activity stats with filtering and ranking, so you can compare chains directly instead of aggregating token or pair data yourself. Each [`NetworkFilterResult`](https://docs.codex.io/api-reference/types/networkfilterresult) exposes total liquidity plus volume, volume change, and transaction counts over five rolling windows (5m, 1h, 4h, 12h, and 24h), alongside display metadata (name, short name, icon) and a `mainnet` flag.

## Use this data for

* **Network leaderboards.** Rank by `volume24` or `swaps24` to power a "top chains" view, and use the `volumeChange*` attributes to surface chains gaining momentum.
* **Network pickers with live context.** Show volume or transaction counts next to each network in a selector, using the included name and icon metadata.
* **Scoping discovery to active chains.** Feed the resulting network IDs into [`filterTokens`](https://docs.codex.io/api-reference/queries/filtertokens) or [`filterPairs`](https://docs.codex.io/api-reference/queries/filterpairs) to focus downstream queries on where activity actually is.

## GraphQL

```
type Query {
  filterNetworks(
    filters: NetworkFilters
    networks: [Int!]
    excludeNetworks: [Int!]
    rankings: [NetworkRanking]
    limit: Int
    offset: Int
  ): NetworkFilterConnection
}

type NetworkFilterResult {
  networkId: Int!
  networkName: String
  networkShortName: String
  networkIconUrl: String
  mainnet: Boolean
  timestamp: Int
  liquidity: String
  volume5m: String
  volume1: String
  volume4: String
  volume12: String
  volume24: String
  volumeChange5m: Float
  volumeChange1: Float
  volumeChange4: Float
  volumeChange12: Float
  volumeChange24: Float
  swaps5m: Int
  swaps1: Int
  swaps4: Int
  swaps12: Int
  swaps24: Int
  chainTransactions5m: Int
  chainTransactions1: Int
  chainTransactions4: Int
  chainTransactions12: Int
  chainTransactions24: Int
  trades5m: Int
  trades1: Int
  trades4: Int
  trades12: Int
  trades24: Int
}

type NetworkFilterConnection {
  results: [NetworkFilterResult]
  count: Int
  offset: Int
}

input NumberFilter {
  gte: Float
  gt: Float
  lte: Float
  lt: Float
}

input NetworkFilters {
  mainnet: Boolean
  liquidity: NumberFilter
  volume5m: NumberFilter
  volume1: NumberFilter
  volume4: NumberFilter
  volume12: NumberFilter
  volume24: NumberFilter
  volumeChange5m: NumberFilter
  volumeChange1: NumberFilter
  volumeChange4: NumberFilter
  volumeChange12: NumberFilter
  volumeChange24: NumberFilter
  swaps5m: NumberFilter
  swaps1: NumberFilter
  swaps4: NumberFilter
  swaps12: NumberFilter
  swaps24: NumberFilter
  chainTransactions5m: NumberFilter
  chainTransactions1: NumberFilter
  chainTransactions4: NumberFilter
  chainTransactions12: NumberFilter
  chainTransactions24: NumberFilter
  trades5m: NumberFilter
  trades1: NumberFilter
  trades4: NumberFilter
  trades12: NumberFilter
  trades24: NumberFilter
}

enum NetworkRankingAttribute {
  liquidity
  volume5m
  volume1
  volume4
  volume12
  volume24
  volumeChange5m
  volumeChange1
  volumeChange4
  volumeChange12
  volumeChange24
  swaps5m
  swaps1
  swaps4
  swaps12
  swaps24
  chainTransactions5m
  chainTransactions1
  chainTransactions4
  chainTransactions12
  chainTransactions24
  trades5m
  trades1
  trades4
  trades12
  trades24
}

enum RankingDirection {
  ASC
  DESC
}

input NetworkRanking {
  attribute: NetworkRankingAttribute
  direction: RankingDirection
}
```

### Example

[Test this query in the Explorer →](https://docs.codex.io/explore.md)

```graphql theme={null}
{
  filterNetworks(
    filters: {mainnet: true, volume24: {gt: 1000000}}
    rankings: [{attribute: volume24, direction: DESC}]
    limit: 10
  ) {
    results {
      networkId
      networkName
      networkShortName
      networkIconUrl
      mainnet
      liquidity
      volume24
      volumeChange24
      swaps24
      timestamp
    }
    count
  }
}
```

### Usage Guidelines

* Use `networks` / `excludeNetworks` to scope the result set by ID before filters are applied.
* `timestamp` is when the network's stats were last updated; use it to gauge freshness.
* See the full list of supported networks on [Networks](https://docs.codex.io/networks.md).
* Response limit: 200 networks per request.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.