# QuickBuild Crypto Price API

> QuickBuild Crypto Price API is a paid API for AI agents from quickbuild.quynguyenbac.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-21).

Returns live price, market cap, 24h volume, and 24h % change for up to 25 cryptocurrencies, looked up by ticker symbol, CoinGecko ID, or token contract address and chain

## Facts

- Endpoint: GET https://quickbuild.quynguyenbac.workers.dev/api/crypto/price?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quickbuild-crypto-price-api-d874a811
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YmhUJigWHUiKN5RzwAvSi

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 quickbuild-crypto-price-api-d874a811
```

Example prompt: What are the current prices, market caps, and 24-hour percent changes for BTC, ETH, and SOL in both USD and EUR?

## When to prefer this

Use this endpoint when you need fast, near-real-time crypto prices (refreshed every 30 seconds) for up to 25 coins at once across multiple quote currencies. It is especially useful when you need market cap and volume data alongside price, when you want to look up a token by its on-chain contract address across major EVM chains and Solana, or when you need a lightweight one-call solution for bulk crypto quotes without managing CoinGecko API keys. Prefer it over raw CoinGecko calls for its ticker-to-ID resolution, multi-currency output, and built-in Coinbase fallback.

## Known failure modes

- Unknown coin ticker or ID returns 404 with a notFound array listing unresolved symbols
- Invalid input parameters (e.g. malformed address, unsupported chain) return 400
- More than 25 symbols in a single request may be rejected
- More than 5 vs currencies may be rejected
- CoinGecko unavailability triggers fallback to Coinbase spot rates (price only, no market cap or volume)
- Token contract address lookup only supported for one address per call; mixing address with symbols/ids may produce unexpected results

## How this service works

Landing pages ($15), Google Sheets/Apps Script automation ($10), scrapers, scripts & Telegram bots (from $15), broken-link + sitemap audit reports ($10). See a working demo first, pay after.

## Output

A JSON object containing an array of price records for each requested coin, each with its CoinGecko ID, symbol, price per quote currency, market cap, 24h volume, 24h percent change, and last-updated timestamp. Also includes the list of quote currencies used, total count, data source (coingecko or coinbase), any tickers not found, and the fetch timestamp. Data is cached for 30 seconds.

## 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": [],
     "properties": {
      "vs": {
       "type": "string",
       "description": "Comma-separated quote currencies (max 5), e.g. usd,eur,btc. Default usd."
      },
      "ids": {
       "type": "string",
       "description": "Comma-separated CoinGecko coin ids, e.g. bitcoin,aerodrome-finance (optional)."
      },
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon",
        "bsc",
        "avalanche",
        "solana"
       ],
       "type": "string",
       "description": "Chain of `address` (default base)."
      },
      "address": {
       "type": "string",
       "description": "Optional token contract address; returns that token price (overrides symbols/ids)."
      },
      "symbols": {
       "type": "string",
       "description": "Comma-separated tickers, e.g. BTC,ETH,SOL (max 25). Optional: defaults to BTC,ETH."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "vs": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "count": {
       "type": "integer"
      },
      "prices": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": [
           "string",
           "null"
          ]
         },
         "price": {
          "type": "object",
          "description": "vs currency -> price"
         },
         "symbol": {
          "type": [
           "string",
           "null"
          ]
         },
         "marketCap": {
          "type": [
           "object",
           "null"
          ]
         },
         "volume24h": {
          "type": [
           "object",
           "null"
          ]
         },
         "lastUpdated": {
          "type": [
           "string",
           "null"
          ]
        
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "vs": [
   "usd"
  ],
  "count": 2,
  "prices": [
   {
    "id": "bitcoin",
    "price": {
     "usd": 82741.26
    },
    "symbol": "BTC",
    "marketCap": {
     "usd": 1663035412060
    },
    "volume24h": {
     "usd": 27544716493
    },
    "lastUpdated": "2026-10-21T01:19:29.000Z",
    "change24hPct": {
     "usd": 1.74
    }
   },
   {
    "id": "ethereum",
    "price": {
     "usd": 2443.38
    },
    "symbol": "ETH",
    "marketCap": {
     "usd": 298503007461
    },
    "volume24h": {
     "usd": 11514544134
    },
    "lastUpdated": "2026-10-21T01:19:29.000Z",
    "change24hPct": {
     "usd": 2.42
    }
   }
  ],
  "source": "coingecko",
  "notFound": [],
  "fetchedAt": "2026-10-21T01:19:31.000Z",
  "cacheSeconds": 30
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/quickbuild-crypto-price-api-d874a811/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from quickbuild.quynguyenbac.workers.dev](https://www.zero.xyz/host/quickbuild.quynguyenbac.workers.dev/llms.txt)
