API endpoints

Base URL: https://sentiment-api.kytona.com

Versions

• Prefer v2 (/v2/...): modern x402 headers and Base + Solana payments.

• Use v1 (/v1/...) only for legacy clients: legacy headers and Base/EVM-only payments.

Public endpoints

Health check

GET /health

Returns API health status, including Redis, MongoDB, and snapshot freshness. No authentication required.

Discovery

GET /discovery/resources

Returns machine-readable metadata about paid resources (paths, pricing, and schemas). This endpoint is public and does not require payment.

Query parameters:

• limit (optional): Maximum number of resources to return

• offset (optional): Number of resources to skip

Paid snapshot endpoints

All snapshot endpoints cost $0.02 per request and require x402 payment.

Snapshot endpoints (v1 + v2)

What you want	v2 (recommended)	v1 (legacy)
Global snapshot	GET /v2/snapshot/global	GET /v1/snapshot/global
Crypto pulse	GET /v2/snapshot/crypto	GET /v1/snapshot/crypto
TradFi pulse	GET /v2/snapshot/tradfi	GET /v1/snapshot/tradfi
Asset view	GET /v2/snapshot/asset/:symbol	GET /v1/snapshot/asset/:symbol

Query parameters:

• format (optional):

  • Omit to receive the full JSON payload

  • Use format=compact_trading to receive the compact trading payload

• fields (compact only): Comma-separated allowlist of compact fields to return

  Supported values: ts, mood, sentiment, corr_status, corr_conf, signals, rec, cost_usdc

  Example: GET /v2/snapshot/crypto?format=compact_trading&fields=ts,mood,rec

Errors

• 402: payment required (see Payment Flow (x402))

• 400: invalid query parameters (INVALID_FORMAT, INVALID_COMPACT_FIELDS)

• 404: unknown/unsupported symbol (UNSUPPORTED_TOKEN)

• 429: rate limited (RATE_LIMITED, RATE_LIMITED_WALLET)

• 503: snapshot not ready (SNAPSHOT_NOT_READY)