# AgentForge Token Research

> AgentForge Token Research is a paid API for AI agents from agentforge-taupe.vercel.app, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-02).

Aggregates CoinGecko market data, DeFiLlama DeFi metrics, Etherscan contract verification, and Polymarket prediction markets into a comprehensive multi-source token due diligence report.

## Facts

- Endpoint: GET https://agentforge-taupe.vercel.app/v1/token-research?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentforge-token-research-bbeeea76
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zrtJh-NaTKd1AIbqcB5DP

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 agentforge-token-research-bbeeea76
```

Example prompt: Give me a full due diligence report on AAVE on Ethereum — include market data, DeFi metrics, contract info, and prediction market sentiment.

## When to prefer this

Choose this endpoint when you need comprehensive, multi-source due diligence on a token rather than a single data point. It is ideal for pre-trade research, risk assessment workflows, or analyst reporting where you want market data, DeFi metrics, contract verification, and prediction market sentiment in one call. Prefer the sibling quick-lookup endpoint for simple price checks, and this endpoint when depth and cross-source aggregation matter.

## Known failure modes

- Token not found on specified chain — returns empty or error if symbol/address doesn't match
- Contract address invalid or not on the specified chain
- Chain enum value unsupported — must be one of ethereum, base, polygon, arbitrum, optimism, avalanche
- CoinGecko or DeFiLlama upstream unavailable — partial data returned or error
- Polymarket has no active markets for the token — prediction_markets section empty
- Query too short or too long — minLength 1, maxLength 200 enforced
- Payment not confirmed — x402 payment required before data is returned

## How this service works

Deep token due diligence for analysts and trading agents: aggregates CoinGecko market data, DeFiLlama DeFi metrics, Etherscan contract verification, and Polymarket prediction markets into one multi-source report. Category: data.

## Output

A multi-source token research report containing any combination of: CoinGecko market data (price, volume, market cap), DeFiLlama DeFi metrics (TVL, liquidity), Etherscan contract verification status, Polymarket prediction market odds, institutional metrics, AI risk assessment scores, historical price data, and holder distribution — depending on which 'include' categories were requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "polygon",
    "arbitrum",
    "optimism",
    "avalanche"
   ],
   "type": "string",
   "default": "ethereum"
  },
  "query": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1,
   "description": "Token name, symbol, or contract address"
  },
  "include": {
   "type": "array",
   "items": {
    "enum": [
     "market_data",
     "defi_metrics",
     "contract_info",
     "prediction_markets",
     "institutional",
     "risk_assessment",
     "price_history",
     "holders"
    ],
    "type": "string"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentforge-token-research-bbeeea76/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentforge-taupe.vercel.app](https://www.zero.xyz/host/agentforge-taupe.vercel.app/llms.txt)