# CortexCloud Token Risk Scoring API

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

Returns an evidence-backed risk score and related intelligence for a given token contract address on a specified blockchain chain.

## Facts

- Endpoint: GET https://api.cortexcloud.org/v1/data/token-risk?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cortexcloud-token-risk-scoring-api-2c885da8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L45cURhJcnX33pg8hspp1

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-risk-scoring-api-2c885da8
```

Example prompt: Check the risk score for the token at Ethereum contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — I want to know if it's safe before I invest.

## When to prefer this

Choose this endpoint when you need a structured, evidence-backed risk score for a specific ERC-20 or compatible token contract without requiring API key signup — especially in autonomous agent workflows where pay-per-call USDC settlement via x402 is preferred over subscription-based token risk APIs. Ideal for pre-trade safety checks, portfolio audits, and due diligence on new or unfamiliar tokens on Ethereum and other supported chains.

## Known failure modes

- Invalid contract address format (must match ^0x[0-9a-fA-F]{40}$) returns a validation error
- Unknown or unsupported chain identifier returns an error
- Contract not found on specified chain returns empty or error response
- Payment failure (insufficient USDC balance or x402 payment not settled) blocks the request
- CoinGecko coin_id not found results in missing age/liquidity fields
- Rate limiting or network congestion on Base may delay payment settlement

## How this service works

Token risk verdict (age, liquidity, contract checks, suspicious-transfer scan) with per-claim evidence. x402-paid.

## Output

Returns a JSON object containing an evidence-backed risk score and supporting data for the specified token contract, potentially including liquidity metrics, token age, risk flags, and other on-chain intelligence fields derived from CoinGecko and blockchain data.

## 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": {
     "type": "string",
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "ethereum",
  "verdict": "low",
  "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "currency": "USDC",
  "evidence": [
   {
    "check": "contract_exists",
    "result": true,
    "source": "alchemy eth_getCode"
   },
   {
    "name": "USDC",
    "check": "token_metadata",
    "source": "alchemy alchemy_getTokenMetadata",
    "symbol": "USDC",
    "decimals": 6
   },
   {
    "check": "age_liquidity",
    "source": "coingecko /coins/usd-coin",
    "age_days": null,
    "genesis_date": null,
    "market_cap_usd": 72074606956,
    "total_volume_usd_24h": 12737136578
   }
  ],
  "cache_hit": false,
  "price_usd": 0.02,
  "risk_flags": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cortexcloud-token-risk-scoring-api-2c885da8/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)