# Agent402 Coin Profile

> Agent402 Coin Profile is a paid API for AI agents from agent402.tools, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Fetches a comprehensive market and metadata profile for a cryptocurrency by its CoinGecko coin ID, including price, market cap, sentiment, links, and categorization.

## Facts

- Endpoint: GET https://agent402.tools/api/coin-profile
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-coin-profile-152791ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HS3lAav1V9xbf2rQ-Zu-j

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 agent402-coin-profile-152791ec
```

Example prompt: Pull the full coin profile for Ethereum in USD — I want the current price, market cap, ATH, 7-day change, sentiment, and any social links or explorer URLs.

## When to prefer this

Use this endpoint when you need a rich, all-in-one profile for a single cryptocurrency — combining real-time market data, metadata, social links, sentiment, and categorization in one call. Prefer this over a simple price ticker when you need context like ATH, supply, description, or categories. Best when the coin ID is already known; use coin-search first if you only have a ticker symbol.

## Known failure modes

- Unknown coin ID returns an error — use the coin-search endpoint first to resolve a ticker symbol to a valid ID
- Invalid currency code may return an error or default to USD
- Rate limiting or upstream CoinGecko unavailability may cause failures
- Cached vs. live data flag indicates freshness; stale data possible during high load

## How this service works

Full profile of one coin by id: name/symbol, description, categories, contract addresses per platform, links (homepage, explorers, repos, social), hashing algorithm, genesis date, and a market snapshot in your currency: price, rank, market cap, fully diluted valuation, 24h volume, ATH/ATL with dates and distance, circulating/total/max supply, 24h/7d/30d/1y change. One call for the metadata a token-risk or research agent otherwise assembles from five. Cached in-process for 5 minutes.

## Output

Returns a JSON object with the coin's name, symbol, CoinGecko rank, current price and market stats (ATH, ATL, 24h high/low, market cap, volume, supply figures, price change percentages over 24h/7d/30d/1y), sentiment percentage, watchlist user count, categories, description, genesis date, hashing algorithm, social and explorer links, and contract platform details. Data is sourced from CoinGecko and timestamped.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "coin"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "description": "Coin id (bitcoin, ethereum, usd-coin, ...). Use coin-search to resolve a symbol."
      },
      "currency": {
       "type": "string",
       "description": "vs currency for the market block (default usd)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "ethereum",
  "name": "Ethereum",
  "rank": 2,
  "links": {
   "repos": [
    "https://github.com/ethereum/go-ethereum"
   ],
   "reddit": "https://www.reddit.com/r/ethereum",
   "twitter": "ethereum",
   "homepage": "https://www.ethereum.org/",
   "explorers": [
    "https://etherscan.io/"
   ],
   "whitepaper": null
  },
  "cached": false,
  "market": {
   "ath": 4878.26,
   "atl": 0.432979,
   "price": 2424.5,
   "low24h": 2390.2,
   "athDate": "2021-11-10T14:24:19.604Z",
   "atlDate": "2015-10-20T00:00:00.000Z",
   "high24h": 2480.1,
   "marketCap": 292876442962,
   "maxSupply": null,
   "volume24h": 14200000000,
   "change1yPct": -12.9,
   "change7dPct": -3.1,
   "lastUpdated": "2026-08-22T13:19:00.000Z",
   "totalSupply": 120700000,
   "athChangePct": -50.3,
   "change24hPct": 1.2,
   "change30dPct": 8.4,
   "circulatingSupply": 120700000,
   "fullyDilutedValuation": 292876442962
  },
  "source": "coingecko",
  "symbol": "ETH",
  "currency": "usd",
  "fetchedAt": "2026-08-22T13:20:00.000Z",
  "platforms": [
   {
    "contract": null,
    "decimals": null,
    "platform": "ethereum"
   }
  ],
  "categories": [
   "Smart Contract Platform",
   "Layer 1 (L1)"
  ],
  "description": "Ethereum is a global, open-source platform for decentralized applications...",
  "genesisDate": "2015-07-30",
  "sentimentUpPct": 71.4,
  "watchlistUsers": 2200000,
  "hashingAlgorithm": "Ethash"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-coin-profile-152791ec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)