# CortexCloud Market Snapshot

> CortexCloud Market Snapshot is a paid API for AI agents from api.cortexcloud.org, paid per call via x402, $0.07/call, status unknown (last checked 2026-11-22).

Returns a comprehensive on-chain market snapshot for a wallet address and token, including token price, risk scoring, whale activity, and transfer history — evidence-backed, multi-source JSON.

## Facts

- Endpoint: GET https://api.cortexcloud.org/v1/data/market-snapshot?utm_source=zero.xyz
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cortexcloud-market-snapshot-d5e9860f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h8OFKq0cM9cDDJI9O3lQ1

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 cortexcloud-market-snapshot-d5e9860f
```

Example prompt: Pull a full market snapshot for the USDC contract at 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 on Ethereum for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want the price, risk verdict, and any whale activity.

## When to prefer this

Choose this endpoint when you need a single-call, evidence-backed market snapshot combining price, risk, whale activity, and transfer history for a specific on-chain token or wallet — especially in DeFi agent workflows where you need auditability (each fact cites its source). Prefer this over raw blockchain RPC calls when you want aggregated multi-source data without managing multiple API keys. Use when operating on Base via x402 pay-per-call and need no signup or subscription overhead.

## Known failure modes

- Invalid contract address returns an error or partial snapshot with failed sections
- Unsupported chain returns a chain-not-found error
- Token not listed on CoinGecko results in missing price/age data with partial:true
- Payment failure (insufficient USDC balance) blocks the call before data is returned
- Rate limits or upstream Alchemy/CoinGecko downtime may cause section failures with sections.failed > 0

## How this service works

One-call market snapshot: token intelligence, whale activity, and risk verdict fanned out in parallel and merged under token/whale_activity/risk with a snapshot_at timestamp. Partial failures return an error key per section instead of failing the whole response. x402-paid, USDC on Base.

## Output

A JSON object containing: token price in USD (sourced from CoinGecko), a risk verdict (low/medium/high) with supporting evidence checks (contract existence, token metadata, age, liquidity), risk flags array, whale activity summary, recent transfer count and latest transfer details, market cap, 24h volume, cache hit status, and a snapshot timestamp. Each fact includes its data source and checked_at timestamp for auditability.

## 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": {
     "type": "string",
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "risk": {
   "chain": "ethereum",
   "verdict": "low",
   "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
   "evidence": [
    {
     "check": "contract_exists",
     "result": true,
     "source": "alchemy eth_getCode"
    },
    {
     "name": "USDC",
     "check": "token_metadata",
     "source": "alchemy alchemy_getTokenMetadata",
     "symbol": "USDC",
     "decimals": 6
    },
    {
     "check": "age_liquidity",
     "source": "coingecko /coins/usd-coin",
     "age_days": null,
     "genesis_date": null,
     "market_cap_usd": 71490748785,
     "total_volume_usd_24h": 5945347909
    },
    {
     "check": "recent_mints",
     "source": "alchemy alchemy_getAssetTransfers",
     "scanned": 100,
     "tx_hash": "0x04c1f82b7b6fd6b8b1bb949a0159e238fb9006286a07d49acbf327c2954623e9",
     "block_num": "0xba4961",
     "direction": "mint",
     "largest_value": 63220
    },
    {
     "check": "recent_burns",
     "source": "alchemy alchemy_getAssetTransfers",
     "scanned": 1,
     "tx_hash": "0xe2e40640ffd5f76538cd23660cf56f00bfebd5fe925ebad6b8067c4cee18a2c3",
     "block_num": "0xbbf476",
     "direction": "burn",
     "largest_value": 858624.355601
    }
   ],
   "cache_hit": false,
   "risk_flags": []
  },
  "chain": "ethereum",
  "token": {
   "chain": "ethereum",
   "facts": {
    "name": {
     "value": "USDC",
     "source": "alchemy alchemy_getTokenMetadata",
     "checked_at": "2026-11-01T15:44:42.317552+00:00"
    },
    "symbol": {
     "value": "USDC",
     "source": "alchemy alchemy_getTokenMetadata",
     "checked_at": "2026-11-01T15:44:42.317552+00:00"
    },
    "age_days": {
     "value": null,
     "source": "coingecko /coins/usd-coin",
     "missing": "no_genesis_date",
     "checked_at": "2026-11-01T15:44:42.317552+00:00"
    },
    "decimals": {
     "value": 6,
     "source": "alchemy alchemy_getTokenMetadata",
     "checked_at": "2026-11-01T15:44:42.317552+00:00"
    },
    "price_usd": {
     "value": 0.999852,
     "source": "coingecko /simple/token_price/ethereum",
     "checked_at": "2026-11-01T15:44:42.317552+00:00"
    },
    "change_24h_usd": {
     "value": -0.005098734648525784,
     "source": "coingecko /simple/token_price/ethereum",
     "checked_at": "2026-11-01T15:44:42.317552+00:00"
    },
    "market_cap_usd": {
     "value": 71490748785,
     "source": "coingecko /coins/usd-coin",
     "checked_at": "2026-11-01T15:44:42.317552+00:00"
    },
    "latest_transfer": {
     "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cortexcloud-market-snapshot-d5e9860f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cortexcloud.org](https://www.zero.xyz/host/api.cortexcloud.org/llms.txt)
