# three.ws Token Intelligence API

> three.ws Token Intelligence API is a paid API for AI agents from three.ws, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns real-time price, momentum, risk assessment, and trading signal for a given crypto token by mint address (Solana or EVM).

## Facts

- Endpoint: GET https://three.ws/api/x402/token-intel?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-token-intelligence-api-fecef3f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3R_XPnoKocrGOIohtZNws

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 three-ws-token-intelligence-api-fecef3f0
```

Example prompt: What's the current risk level and trading signal for the Solana token with mint address FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump? I want price, momentum, liquidity, and whether it's bullish or bearish.

## When to prefer this

Use this endpoint when you need a single, fast risk-plus-signal snapshot for a specific token by contract address, especially on Solana or EVM chains. It bundles price, momentum, liquidity, and risk scoring into one call for $0.01 USDC, making it ideal for pre-trade checks, agent-driven portfolio audits, or any workflow that needs a machine-readable 'safe to trade?' verdict without querying multiple data sources separately.

## Known failure modes

- Invalid or malformed mint address returns an error — address must be 32–64 characters
- Token not found on supported chains returns null or 404-equivalent
- Low-liquidity or very new tokens may return incomplete risk factors
- Payment of $0.01 USDC not provided triggers 402 Payment Required
- Network or oracle outage may cause stale or missing price data

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

A JSON object containing: token symbol and name, current USD price, 24h percentage change, momentum readings at 5m/1h/6h/24h intervals, liquidity in USD, market cap, 24h volume, an overall trading signal (e.g. 'bullish'), a risk object with level (low/medium/high), numeric score, and a list of labeled risk factors (liquidity, age, float, flow), plus a confidence score (0–1), a one-line headline, and a human-readable rationale paragraph.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "mint"
     ],
     "properties": {
      "mint": {
       "type": "string",
       "maxLength": 64,
       "minLength": 32,
       "description": "Token contract address — Solana base58 mint or EVM 0x address."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-06-12T10:00:00Z",
  "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",
  "name": "three.ws",
  "risk": {
   "level": "low",
   "score": 8,
   "factors": [
    {
     "label": "Liquidity",
     "detail": "$412,000 pooled — healthy depth.",
     "status": "low"
    },
    {
     "label": "Age",
     "detail": "Pair is 240d old — established.",
     "status": "low"
    },
    {
     "label": "Float",
     "detail": "Cap is 8.9× liquidity — well backed.",
     "status": "low"
    },
    {
     "label": "Flow",
     "detail": "63% of 24 h trades are buys — net accumulation.",
     "status": "low"
    }
   ],
   "summary": "THREE clears the basic depth, age, and flow checks."
  },
  "chain": "solana",
  "signal": "bullish",
  "symbol": "THREE",
  "headline": "THREE climbs +12.40% — moderate upside",
  "momentum": {
   "h1": 1.8,
   "h6": 6.1,
   "m5": 0.3,
   "h24": 12.4
  },
  "price_usd": 0.003685,
  "rationale": "THREE is up +12.40% over 24 h, trading at $0.003685. Volume is healthy against liquidity; participation is real. Buyers dominate the tape. The last hour confirms the trend.",
  "change_24h": 12.4,
  "confidence": 0.86,
  "liquidity_usd": 412000,
  "market_cap_usd": 3685000,
  "volume_24h_usd": 1268079
 }
}
```

## More

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