# Capminal Token Deep Research API

> Capminal Token Deep Research API is a paid API for AI agents from www.capminal.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Performs AI-powered deep research and analysis on a specific blockchain token given its chain ID and contract address

## Facts

- Endpoint: GET https://www.capminal.ai/api/x402/research
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/www-capminal-ai-dd9dfa2a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YjUvZDWbt0ZhZH9qG4YDA

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 www-capminal-ai-dd9dfa2a
```

Example prompt: Can you give me a deep AI research report on the token at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base (chain ID 8453) — I want the price, market cap, holder count, and an AI analysis of what this token is?

## When to prefer this

Choose this endpoint when you need both structured token market data (price, market cap, FDV, holders) AND an AI-generated narrative analysis of a token in a single call, especially for tokens on Base or other EVM chains. Prefer over raw DEX/CEX data APIs when you want an interpretive research summary rather than just raw numbers.

## Known failure modes

- Invalid or unsupported chainId returns an error or empty result
- Token contract address not found on the specified chain returns no data
- Malformed contract address causes a 400-level error
- Payment not received results in 402 Payment Required
- Token exists but has no market data yet returns partial fields

## How this service works

AI-powered Token Deep Research API

## Output

Returns an AI-generated analysis string along with structured token info including name, symbol, contract address, current price in USD, market cap, fully diluted valuation (FDV), and holder count for the specified token on the specified chain.

## Example request

```json
{
 "chainId": "1",
 "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chainId": {
   "type": "string"
  },
  "tokenAddress": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "chainId": {
    "type": "string",
    "required": true,
    "description": "EVM chain ID (e.g., 8453 for Base)"
   },
   "tokenAddress": {
    "type": "string",
    "required": true,
    "description": "Token contract address"
   }
  },
  "headerFields": {
   "X-PAYMENT": {
    "type": "string",
    "description": "Payment proof on retry"
   }
  }
 },
 "properties": {
  "analysis": {
   "type": "string",
   "description": "AI-generated comprehensive analysis of the token"
  },
  "tokenInfo": {
   "type": "object",
   "properties": {
    "id": {
     "type": "string"
    },
    "type": {
     "type": "string"
    },
    "attributes": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string"
      },
      "symbol": {
       "type": "string"
      },
      "address": {
       "type": "string"
      },
      "fdv_usd": {
       "type": "string"
      },
      "holders": {
       "type": "object",
       "properties": {
        "count": {
         "type": "number"
        }
       }
      },
      "gt_score": {
       "type": "number"
      },
      "image_url": {
       "type": "string"
      },
      "price_usd": {
       "type": "string"
      },
      "volume_usd": {
       "type": "object",
       "properties": {
        "h24": {
         "type": "string"
        }
       }
      },
      "description": {
       "type": "string"
      },
      "market_cap_usd": {
       "type": "string"
      },
      "normalized_total_supply": {
       "type": "string"
      }
     }
    }
   },
   "description": "Token Information"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/www-capminal-ai-dd9dfa2a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.capminal.ai](https://www.zero.xyz/host/www.capminal.ai/llms.txt)