Coin profile
GET /api/coin-profileFull profile of one coin by id: name/symbol, description, categories, contract addresses per platform, links (homepage, explorers, repos, social), hashing algorithm and genesis date. Send GET /api/coin-profile with the required field coin and pay $0.008 per call over x402 or MPP (there is no free tier). It returns a JSON object with source, fetchedAt, cached, id, symbol and 13 more.
Adds 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. Data provided by CoinGecko (https://www.coingecko.com/en/api).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
coin | string | yes | Coin id (bitcoin, ethereum, usd-coin, ...). Use coin-search to resolve a symbol. Also accepted as symbol, id, ticker, asset. |
currency | string | no | vs currency for the market block (default usd). |
Example request
curl -i "https://agent402.tools/api/coin-profile?coin=ethereum¤cy=usd"
Without payment this returns HTTP 402 Payment Required with the exact price for coin-profile; any x402 v2 or MPP client pays it and retries.
Watch a call get paid
GET /api/coin-profile$0.008 USDCPAYMENT-SIGNATUREon 14 chains200 OKAgent402-ReceiptEd25519Example response
{
"source": "coingecko",
"fetchedAt": "2026-08-22T13:20:00.000Z",
"cached": false,
"id": "ethereum",
"symbol": "ETH",
"name": "Ethereum",
"rank": 2,
"currency": "usd",
"description": "Ethereum is a global, open-source platform for decentralized applications...",
"categories": [
"Smart Contract Platform",
"Layer 1 (L1)"
],
"platforms": [
{
"platform": "ethereum",
"contract": null,
"decimals": null
}
],
"links": {
"homepage": "https://www.ethereum.org/",
"explorers": [
"https://etherscan.io/"
],
"repos": [
"https://github.com/ethereum/go-ethereum"
],
"twitter": "ethereum",
"reddit": "https://www.reddit.com/r/ethereum",
"whitepaper": null
},
"hashingAlgorithm": "Ethash",
"genesisDate": "2015-07-30",
"market": {
"price": 2424.5,
"marketCap": 292876442962,
"fullyDilutedValuation": 292876442962,
"volume24h": 14200000000,
"high24h": 2480.1,
"low24h": 2390.2,
"change24hPct": 1.2,
"change7dPct": -3.1,
"change30dPct": 8.4,
"change1yPct": -12.9,
"ath": 4878.26,
"athDate": "2021-11-10T14:24:19.604Z",
"athChangePct": -50.3,
"atl": 0.432979,
"atlDate": "2015-10-20T00:00:00.000Z",
"circulatingSupply": 120700000,
"totalSupply": 120700000,
"maxSupply": null,
"lastUpdated": "2026-08-22T13:19:00.000Z"
},
"sentimentUpPct": 71.4,
"watchlistUsers": 2200000,
"credit": "Data provided by CoinGecko (https://www.coingecko.com/en/api)."
}| Field | Type | Always present | In the example |
|---|---|---|---|
source | string | yes | coingecko |
fetchedAt | string | yes | 2026-08-22T13:20:00.000Z |
cached | boolean | yes | false |
id | string | yes | ethereum |
symbol | string | yes | ETH |
name | string | yes | Ethereum |
rank | number | yes | 2 |
currency | string | yes | usd |
description | string | yes | Ethereum is a global, open-source platform for decentralized applications... |
categories | array of string | yes | 2 items in the example |
platforms | array of objects | yes | 1 item in the example |
links | object | yes | 6 fields: homepage, explorers, repos, twitter, reddit, whitepaper |
hashingAlgorithm | string | yes | Ethash |
genesisDate | string | yes | 2015-07-30 |
market | object | yes | 19 fields: price, marketCap, fullyDilutedValuation, volume24h and 15 more |
sentimentUpPct | number | yes | 71.4 |
watchlistUsers | number | yes | 2200000 |
credit | string | yes | Data provided by CoinGecko (https://www.coingecko.com/en/api). |
From an MCP client
catalog.call {
"slug": "coin-profile",
"params": {
"coin": "ethereum",
"currency": "usd"
}
}The hosted connector at https://agent402.tools/mcp needs a payment for coin-profile; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.14.1.
Errors and behavior
coinis required. An input the tool rejects returns an HTTP 4xx whose body carrieserror,tool,expected,requiredandexample, so the caller can correct it.- A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement runs after the tool and only on a successful response. The exception is a Tempo push credential, a transfer the buyer sent before the call: it settles before the tool runs, so if the tool then fails the payment is recorded as a refund owed to the paying wallet.
- Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - A
POSTwith a JSON body to /api/coin-profile is served as this GET, with the body as the input. - An
Idempotency-Keyheader makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB is not replayed).
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
client.setSpendControls?.({ maxAmountPerPayment: "$0.008" }); // refuse any quote above this tool's price
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/coin-profile?coin=ethereum¤cy=usd");Part of these workflows
Coin profile is one step in this skill pack, each sold as a single call:
- DeFi protocol scanner - Due-diligence a DeFi protocol in one workflow: live token price, market context, the token's fundamentals (supply, valuation, all-time high and low, links), and recent news - the market and off-chain picture together.
Related tools
Tokenized asset
One tokenized real-world asset by id (gold, nvidia, tesla, spy ...): identity, type, image and web slug joined.
Token price by contract address
Live price, market cap, 24h volume and 24h change for ERC-20 / SPL / other chain tokens looked up by CONTRACT ADDRESS.
NFT metadata lookup
Resolve the metadata for a single NFT: title, description, image URLs (original + cached CDN), attributes/traits.
Tokenized asset issuer
One issuer of tokenized real-world assets by id: aggregate tokenized market cap, 24h cap change and 24h volume, plus.
Tokenized asset markets
Live market rows for tokenized real-world assets (stocks, ETFs and commodities such as gold), ranked by market cap.
ERC-20 token metadata
Resolve an ERC-20 contract address to its on-chain metadata: symbol, decimals, name, and logo URL where available.