# meld402 Market Pulse

> meld402 Market Pulse is a paid API for AI agents from meld402.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a unified crypto market overview combining global market cap stats, Bitcoin dominance, Fear & Greed index sentiment, and top DeFi chain TVL rankings in one call.

## Facts

- Endpoint: POST https://meld402.vercel.app/api/market/pulse
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meld402-market-pulse-45c75e45
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WfCCAzdSgIz2WB001AnoI

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 meld402-market-pulse-45c75e45 -d '<json body>'
```

Example prompt: Give me a full crypto market pulse right now — show the global market cap, Bitcoin dominance, Fear & Greed sentiment, and include the top 5 chains by DeFi TVL.

## When to prefer this

Choose this endpoint when you need a single-call macro overview of the crypto market combining sentiment, dominance, volume, and DeFi TVL — rather than making separate calls to Coinpaprika, DefiLlama, and Fear & Greed APIs individually. Ideal for dashboards, morning briefings, trading condition checks, or any agent that needs to orient itself to overall market state before taking action. The $0.05 flat fee covers all three upstream sources in one stable schema.

## Known failure modes

- Upstream source unavailable — affected source listed in meta.degraded, partial data still returned
- Invalid top_chains value above 25 or below 0 — returns validation error
- Payment not settled over x402 — 402 response requiring USDC payment on Base before data is served
- Network timeout from one or more aggregated sources — partial response with degraded sources flagged

## How this service works

14 paid data endpoints for autonomous agents and developers. Covers crypto intelligence (token, chain, Solana, gas), markets (FX, market pulse), location (weather), and research (news, brief). Each route aggregates multiple public sources into one stable schema with a single USDC payment over x402 on Base.

## Output

Returns a JSON object with three blocks: 'market' (total market cap, 24h volume, Bitcoin dominance %, volume and cap 24h change %, tracked asset count, timestamp), 'sentiment' (Fear & Greed numeric value and text classification, publication date), and 'chains' (array of top N chains with name, TVL in USD, and token symbol, ranked by TVL descending). Also includes a 'meta' block with sources used, degraded sources if any, and attribution strings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "top_chains": {
   "type": "integer",
   "default": 5,
   "maximum": 25,
   "minimum": 0,
   "description": "How many chains to include, largest TVL first. Set 0 to skip the DefiLlama lookup entirely."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "chains": [
    {
     "name": "Ethereum",
     "tvl_usd": 60400000000,
     "token_symbol": "ETH"
    },
    {
     "name": "Solana",
     "tvl_usd": 9800000000,
     "token_symbol": "SOL"
    },
    {
     "name": "Base",
     "tvl_usd": 5100000000,
     "token_symbol": null
    }
   ],
   "market": {
    "last_updated": "2026-08-23T21:04:33.000Z",
    "tracked_assets": 13475,
    "total_market_cap_usd": 2750888368282,
    "total_volume_24h_usd": 152778053326,
    "bitcoin_dominance_percent": 56.57,
    "volume_change_24h_percent": -38.8,
    "market_cap_change_24h_percent": 0.74
   },
   "sentiment": {
    "published_at": "2026-08-23T00:00:00.000Z",
    "fear_greed_value": 66,
    "fear_greed_classification": "Greed"
   }
  },
  "meta": {
   "as_of": "2026-08-24T00:00:00.000Z",
   "sources": [
    "coinpaprika",
    "feargreed",
    "defillama"
   ],
   "degraded": [],
   "attribution": [
    "Market data by Coinpaprika (coinpaprika.com)"
   ]
  }
 }
}
```

## More

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