# CortexCloud Token Intelligence

> CortexCloud Token Intelligence is a paid API for AI agents from api.cortexcloud.org, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-14).

Returns comprehensive on-chain and market intelligence for an ERC-20 token, including deployment status, symbol, spot price, 24h change, liquidity, market cap, and recent transfer activity — each fact with its data source and timestamp.

## Facts

- Endpoint: GET https://api.cortexcloud.org/v1/data/token-intel?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cortexcloud-token-intelligence-60ba505a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_td-iLw2herxkjXC2f8YWP

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 cortexcloud-token-intelligence-60ba505a
```

Example prompt: Can you pull up the full token intelligence for the USDC contract at 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 on Ethereum — I want the spot price, liquidity, recent transfer count, and any risk flags?

## When to prefer this

Choose this endpoint when you need a single call that aggregates on-chain deployment status, real-time price, liquidity, risk assessment, and recent transfer activity for an ERC-20 token — avoiding the need to stitch together separate Alchemy and CoinGecko calls yourself. Ideal for agent workflows that need to vet unknown tokens, monitor DeFi positions, or enrich token data before executing trades. Prefer it over raw blockchain RPC calls when you need market context (price, liquidity, age) alongside on-chain facts in one response.

## Known failure modes

- Invalid contract address format (must match ^0x[0-9a-fA-F]{40}$) returns validation error
- Contract not found on specified chain returns contract_deployed: false with no price data
- Unsupported chain value returns an error response
- CoinGecko coin_id mismatch causes age/liquidity/market-cap facts to be absent
- Upstream Alchemy or CoinGecko outage may cause individual facts to be missing or stale
- Payment failure via x402 returns 402 before any data is returned

## How this service works

Flagship token intelligence: deployment, metadata, spot price, 24h change, optional age/liquidity/market-cap, and recent activity. Each fact carries its source, a checked_at timestamp, and explicit missing-data indicators. Alchemy + CoinGecko. x402-paid, USDC on Base.

## Output

A JSON object keyed by 'facts', where each fact (symbol, price_usd, age_days, liquidity_usd_24h, recent_transfer_count, contract_deployed, latest_transfer) carries its value, the data source (Alchemy or CoinGecko endpoint), and a checked_at timestamp. Also includes a top-level risk verdict (e.g. 'low'), an array of risk_flags, the provider cost in USD, and the canonical contract address and chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "default": "ethereum"
  },
  "coin_id": {
   "type": "string",
   "description": "Optional CoinGecko coin id for age/liquidity/market-cap context."
  },
  "contract": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "format": "application/json",
 "example": {
  "chain": "ethereum",
  "facts": {
   "symbol": {
    "value": "USDC",
    "source": "alchemy alchemy_getTokenMetadata",
    "checked_at": "2026-10-14T09:00:00+00:00"
   },
   "age_days": {
    "value": 2000,
    "source": "coingecko /coins/usd-coin",
    "checked_at": "2026-10-14T09:00:00+00:00"
   },
   "price_usd": {
    "value": 1.0001,
    "source": "coingecko /simple/token_price/ethereum",
    "checked_at": "2026-10-14T09:00:00+00:00"
   },
   "latest_transfer": {
    "value": {
     "to": "0x...",
     "from": "0x...",
     "hash": "0x...",
     "value": 100,
     "block_num": "0x...",
     "timestamp": "2026-10-14T08:59:00Z"
    },
    "source": "alchemy alchemy_getAssetTransfers",
    "checked_at": "2026-10-14T09:00:00+00:00"
   },
   "contract_deployed": {
    "value": true,
    "source": "alchemy eth_getCode",
    "checked_at": "2026-10-14T09:00:00+00:00"
   },
   "liquidity_usd_24h": {
    "value": 5000000000,
    "source": "coingecko /coins/usd-coin",
    "checked_at": "2026-10-14T09:00:00+00:00"
   },
   "recent_transfer_count": {
    "value": 25,
    "source": "alchemy alchemy_getAssetTransfers",
    "checked_at": "2026-10-14T09:00:00+00:00"
   }
  },
  "verdict": "low",
  "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "currency": "USDC",
  "price_usd": 0.03,
  "risk_flags": [],
  "provider_cost_usd": 0.00005625
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cortexcloud-token-intelligence-60ba505a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cortexcloud.org](https://www.zero.xyz/host/api.cortexcloud.org/llms.txt)