# x402factory.ai Coin Price Endpoint

> x402factory.ai Coin Price Endpoint is a paid API for AI agents from x402factory.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns spot price and 24h stats (change, high, low) for major large-cap crypto tokens, optionally filtered to a single ticker, paid per-request via x402.

## Facts

- Endpoint: POST https://x402factory.ai/base/coinprice
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402factory-ai-22cec7c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_srjbe58VLdjZUNqjHyBgF

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 x402factory-ai-22cec7c3 -d '<json body>'
```

Example prompt: What's the current spot price and 24-hour stats for BTC — including the price change, high, and low?

## When to prefer this

Use this endpoint when an agent needs a fast, cheap ($0.001 USDC) spot price or 24h market snapshot for a well-known large-cap cryptocurrency. Ideal when you need price, change rate, high, and low in a single call without a full exchange API integration. Not suitable for microcaps or historical OHLCV data.

## Known failure modes

- Unknown or microcap ticker returns an error — only large-cap coins like btc, eth, sol, xmr, ltc are supported
- Missing x402 payment header causes 402 Payment Required response
- Malformed JSON body returns 400 Bad Request
- Network or upstream price feed outage returns 500 or timeout

## How this service works

Base coin price mini-endpoint for major tokens only. Returns spot prices and 24h stats for well-known tickers like btc, solana, eth, xmr, ltc and other large-cap coins, never microcaps. Pass an optional ticker to get a single-coin 24h snapshot with price, symbol, changeRate, changePrice, high and low, or omit ticker to receive a compact basket of top tokens in a fixed order. Cost: 0.001 USDC per request.

## Output

A JSON object containing spot price, symbol, 24h change rate, 24h change price, 24h high, and 24h low for the requested ticker; or a compact basket of top tokens if no ticker is specified.

## Example request

```json
{
 "ticker": "btc"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ticker": {
   "type": "string",
   "description": "Optional ticker symbol for a single major token (case-insensitive). Examples: btc, solana, eth, xmr, ltc. When omitted the endpoint returns a compact basket of top tokens instead."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "ok": {
  "type": "boolean",
  "description": "True on success."
 },
 "low": {
  "type": "number",
  "description": "24h low price for the asset (single mode only)."
 },
 "high": {
  "type": "number",
  "description": "24h high price for the asset (single mode only)."
 },
 "mode": {
  "type": "string",
  "description": "Result mode: 'single' when ticker is provided, 'top' when ticker is omitted."
 },
 "price": {
  "type": "number",
  "description": "Spot price for the asset, using the upstream best bid/last price in a stable quote asset."
 },
 "prices": {
  "type": "array",
  "description": "For mode='top': ordered array of { ticker, symbol, price } for a fixed basket of major tokens, in the order: btc, solana, eth, xmr, bnb, xrp, trx, doge, ada, bch, hype, link, leo, xlm, zec, ltc, avax, hbar, dai, shib, ton, mnt, wlfi, cro."
 },
 "symbol": {
  "type": "string",
  "description": "Upstream trading symbol for the asset (e.g. BTC-USDT for single mode, or base asset symbol like BTC in the top basket)."
 },
 "ticker": {
  "type": "string",
  "description": "Normalized lower-case ticker that was resolved (single mode only)."
 },
 "changeRate": {
  "type": "number",
  "description": "Relative 24h change rate over the recent period for the asset (single mode only)."
 },
 "changePrice": {
  "type": "number",
  "description": "Absolute 24h price change over the recent period for the asset (single mode only)."
 }
}
```

## More

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