# CHAIN VAULT API – USDC Supply Lookup

> CHAIN VAULT API – USDC Supply Lookup is a paid API for AI agents from x402-tc-agent-server.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Returns the current USDC supply or circulating token data from a blockchain gateway endpoint

## Facts

- Endpoint: GET https://x402-tc-agent-server.vercel.app/api/supply-usdc?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chain-vault-api-usdc-supply-lookup-f09a04a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AV6pfRzA0-qPgxjUxCyUk

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 chain-vault-api-usdc-supply-lookup-f09a04a6
```

Example prompt: Can you check the current USDC supply on the Chain Vault blockchain gateway and tell me the latest circulating token figures?

## When to prefer this

Choose this endpoint when you need programmatic, pay-per-call access to USDC supply data via the x402 micropayment protocol on a serverless blockchain gateway. It is appropriate for agents that already handle x402 payment flows and need lightweight, on-demand supply lookups without a persistent API key subscription.

## Known failure modes

- Payment not received or insufficient USDC balance results in 402 Payment Required response
- Blockchain node or gateway downtime causes 503 or timeout
- Malformed or missing required query parameters return 400 Bad Request
- Rate limiting may return 429 if called too frequently
- Response may return status 'ok' with incomplete data if chain sync is lagging

## How this service works

Blockchain Gateway Service

## Output

Returns a JSON object with a status field (e.g. 'ok') and likely includes current USDC supply or token circulation data from the blockchain gateway. Exact supply figures depend on the live chain state at time of query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chain-vault-api-usdc-supply-lookup-f09a04a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-tc-agent-server.vercel.app](https://www.zero.xyz/host/x402-tc-agent-server.vercel.app/llms.txt)