# NetIntel Token Info

> NetIntel Token Info is a paid API for AI agents from netintel.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns a full ERC-20 token profile by contract address, combining on-chain identity data (name, symbol, decimals, supply, holders) with live DEX price, liquidity, and volume for Base and Ethereum.

## Facts

- Endpoint: GET https://netintel.dev/token/info
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netintel-token-info-9afd432b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_U_1-uGaPeUEdBEJNPETik

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability netintel-token-info-9afd432b
```

Example prompt: What's the current price, liquidity, and holder count for the ERC-20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?

## When to prefer this

Choose this endpoint when you need a single call to get both on-chain ERC-20 identity data and live DEX market stats (price, liquidity, volume) for Base or Ethereum tokens without managing API keys or separate RPC and DEX data integrations. It is especially useful for evaluating new or unlisted tokens where centralized exchange data is unavailable, since identity is read directly from the chain and cannot be spoofed. Prefer it over manual RPC calls or separate DEX APIs when you need holder counts alongside market data in one response.

## Known failure modes

- Invalid or malformed contract address returns an error or null fields
- Contract address that is not an ERC-20 token returns is_contract: false with null token fields
- Token with no DEX listing returns nulls for price/liquidity/volume with a no_dex_liquidity finding
- Unsupported chain value returns an error
- Cached response up to 10 minutes old may not reflect very recent price moves
- Rate limiting or RPC downtime may cause degraded or stale data (stale: true flag)

## How this service works

Full profile for any ERC-20 token by contract address — name, symbol, decimals, supply from the chain itself, plus live price, liquidity, and volume from DEX data — Base and Ethereum, no API key. Holder count included; identity read on-chain so it can't lie or be rate-limited away. 10min cache; unlisted tokens return nulls with a no_dex_liquidity finding.

## Output

A JSON object containing the token's on-chain identity (name, symbol, decimals, total_supply in raw atomic units and formatted, is_contract flag, holder count), live market data from DEX aggregation (price_usd, liquidity_usd, volume_24h_usd, top_pool with dex name and URL), metadata about the data source and cache age, and a findings array with flags such as no_dex_liquidity for unlisted tokens. Null values are returned for market fields when no DEX data exists.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "base (default) or ethereum (eth accepted). Alias: network"
      },
      "address": {
       "type": "string",
       "description": "ERC-20 contract address: 0x + 40 hex chars, checksum case ignored. Aliases: contract, token, contract_address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "name": {
       "type": [
        "string",
        "null"
       ]
      },
      "chain": {
       "type": "string"
      },
      "stale": {
       "type": "boolean"
      },
      "source": {
       "type": "string",
       "description": "e.g. \"rpc+dexscreener+blockscout\""
      },
      "symbol": {
       "type": [
        "string",
        "null"
       ]
      },
      "address": {
       "type": "string"
      },
      "holders": {
       "type": [
        "number",
        "null"
       ]
      },
      "decimals": {
       "type": [
        "number",
        "null"
       ]
      },
      "findings": {
       "type": "array"
      },
      "top_pool": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "dex": {
         "type": "string"
        },
        "url": {
         "type": [
          "string",
          "null"
         ]
        },
        "pair": {
         "type": "string"
        }
       }
      },
      "price_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "is_contract": {
       "type": "boolean"
      },
      "total_supply": {
       "type": [
        "string",
        "null"
       ],
       "description": "raw atomic units as a decimal string — can exceed Number.MAX_SAFE_INTEGER"
      },
      "liquidity_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "volume_24h_usd": {
       "t
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "chain": "base",
  "stale": false,
  "source": "rpc+dexscreener+blockscout",
  "symbol": "USDC",
  "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "holders": 12726127,
  "decimals": 6,
  "findings": [],
  "top_pool": {
   "dex": "uniswap",
   "url": "https://dexscreener.com/base/0xa0ab20a64f46b5676fe1542cb87b454e5104007689e0eef4212aa0cbe34933a1",
   "pair": "USDC/USDbC"
  },
  "price_usd": 0.9999,
  "is_contract": true,
  "total_supply": "4156545500926116",
  "liquidity_usd": 907385.42,
  "volume_24h_usd": 803.46,
  "cache_age_seconds": 0,
  "total_supply_formatted": 4156545500.926116
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netintel-token-info-9afd432b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from netintel.dev](https://www.zero.xyz/host/netintel.dev/llms.txt)
