# three.ws Market Pulse

> three.ws Market Pulse is a paid API for AI agents from three.ws, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-23).

Returns a real-time snapshot of cryptocurrency market data including Bitcoin price, total market cap, DeFi TVL, gas prices, stablecoin market cap, and fear & greed index.

## Facts

- Endpoint: GET https://three.ws/api/x402/market-pulse?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-market-pulse-dc3910c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mfw3EJQSDtqLVDy5AN4Hp

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 three-ws-market-pulse-dc3910c2
```

Example prompt: Give me a quick snapshot of the crypto market right now — Bitcoin price, total market cap, fear and greed index, ETH gas fees, and DeFi TVL.

## When to prefer this

Choose this endpoint when you need a single aggregated crypto market snapshot covering multiple metrics (price, dominance, DeFi, gas, sentiment) in one call rather than querying multiple specialized APIs. Useful for dashboards, agents needing market context, or briefings where breadth matters more than deep per-asset data. The micropayment model ($0.005 USDC) makes it cost-effective for frequent polling.

## Known failure modes

- Payment not received or insufficient USDC — returns 402 Payment Required
- Upstream data provider unavailable — may return 503 or stale/empty data
- Malformed request — returns 400 Bad Request
- Rate limiting if payment is disputed — returns 429

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object with: current ETH price in USD and standard gas in gwei; total DeFi TVL in USD; global BTC dominance percentage and total crypto market cap; an array of top coins with symbol, price, and 24h percentage change; a fear & greed index value and label (e.g. 'Greed'); and total stablecoin market cap.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "gas": {
   "eth_price_usd": 3251.7,
   "standard_gwei": 6.4
  },
  "defi": {
   "total_tvl": 208000000000
  },
  "global": {
   "btc_dominance": 54.6,
   "total_market_cap": 3920000000000
  },
  "top_coins": [
   {
    "id": "bitcoin",
    "price": 108234.12,
    "symbol": "BTC",
    "change_24h": 1.42
   }
  ],
  "fear_greed": {
   "label": "Greed",
   "value": 72
  },
  "stablecoins": {
   "total_mcap": 254000000000
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-market-pulse-dc3910c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)