# Token filter

Requires the token to remain inside configured market-cap, age, holder and observed Pump global-fee ranges.

Node ID: `token-filter` · Category: Filters · Minimum plan: Tier 1 and above

Human page: https://docs.orbi.gg/nodes/token-filter

## How it works

Keep a candidate inside configured market-cap, age, holder and observed Pump global-fee limits.

Enable at least one threshold. For paired minimum and maximum limits, an enabled minimum must stay below its enabled maximum.

## Settings

| Setting | Config key | Initial value | Details |
| --- | --- | --- | --- |
| Minimum market cap | `minimumMarketCapUsd` | 5000 | Require at least this market cap. Editor range: 0 to 1000000000. Zero disables this threshold. |
| Maximum market cap | `maximumMarketCapUsd` | 0 | Reject tokens above this market cap. Editor range: 0 to 1000000000. Zero disables this threshold. |
| Minimum token age | `minimumAgeMinutes` | 0 | Minimum age in seconds. 60 is one minute; 1800 is thirty minutes. Editor range: 0 to 31536000. Zero disables this threshold. The editor displays the stored value × 60. |
| Maximum token age | `maximumAgeMinutes` | 0 | Maximum age in seconds. 60 is one minute; 1800 is thirty minutes. Editor range: 0 to 31536000. Zero disables this threshold. The editor displays the stored value × 60. |
| Minimum holders | `minimumHolders` | 0 | Require at least this many observed holders. Editor range: 0 to 10000000. Zero disables this threshold. |
| Maximum holders | `maximumHolders` | 0 | Reject tokens above this holder count. Editor range: 0 to 10000000. Zero disables this threshold. |
| Minimum global fees paid | `minimumGlobalFeesPaidSol` | 0 | Require at least this much decoded Pump global protocol fee activity in SOL. Missing coverage fails closed. Editor range: 0 to 1000000. Zero disables this threshold. |
| Maximum global fees paid | `maximumGlobalFeesPaidSol` | 0 | Reject tokens above this much decoded Pump global protocol fee activity in SOL. Editor range: 0 to 1000000. Zero disables this threshold. |

### Stored defaults

```json
{
  "minimumMarketCapUsd": 5000,
  "maximumMarketCapUsd": 0,
  "minimumAgeMinutes": 0,
  "maximumAgeMinutes": 0,
  "minimumHolders": 0,
  "maximumHolders": 0,
  "minimumGlobalFeesPaidSol": 0,
  "maximumGlobalFeesPaidSol": 0
}
```

## Connections

These lists show compatible node types, not approval of every graph. Branch, position context, subscription, no-cycle and complete-exit rules also apply. A node cannot connect to itself.

Accepts from: [Aegis wallet feed](https://docs.orbi.gg/nodes/aegis-wallet-feed), [Wallet signal](https://docs.orbi.gg/nodes/wallet-signal), [Wallet confirmation](https://docs.orbi.gg/nodes/wallet-confirmation), [Wallet conviction](https://docs.orbi.gg/nodes/wallet-conviction), [Runner potential](https://docs.orbi.gg/nodes/runner-potential), [Twitter traction](https://docs.orbi.gg/nodes/twitter-traction), [Token filter](https://docs.orbi.gg/nodes/token-filter), [Balance](https://docs.orbi.gg/nodes/balance-check), [Entry chase](https://docs.orbi.gg/nodes/entry-chase), [Demand confirmation](https://docs.orbi.gg/nodes/demand-confirmation)

Connects to: [Wallet confirmation](https://docs.orbi.gg/nodes/wallet-confirmation), [Twitter traction](https://docs.orbi.gg/nodes/twitter-traction), [Token filter](https://docs.orbi.gg/nodes/token-filter), [Balance](https://docs.orbi.gg/nodes/balance-check), [Entry chase](https://docs.orbi.gg/nodes/entry-chase), [Demand confirmation](https://docs.orbi.gg/nodes/demand-confirmation), [Open trade](https://docs.orbi.gg/nodes/open-trade), [Telegram notification](https://docs.orbi.gg/nodes/telegram-notify), [Discord notification](https://docs.orbi.gg/nodes/discord-notify), [Skip trade](https://docs.orbi.gg/nodes/skip-trade), [End](https://docs.orbi.gg/nodes/end)

## Before you run

- Zero disables each optional threshold. Missing required observations block the candidate.

- The editor displays token ages in seconds; the internal minimumAgeMinutes and maximumAgeMinutes keys store minutes.

[Full graph rules](https://docs.orbi.gg/guides/graphs) · [Paper assumptions](https://docs.orbi.gg/guides/paper-trading)
