sentiment402 API reference

The Sentiment402 API provides paid sentiment snapshots for Crypto and TradFi markets.

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

  • Recommended version: v2 (/v2/...) — modern x402 headers + Base and Solana payments

  • Legacy version: v1 (/v1/...) — legacy headers + Base/EVM-only payments

Authentication (x402)

Most endpoints are paywalled with x402. When you call a paid endpoint without payment, you’ll receive:

  • HTTP 402 with a PAYMENT-REQUIRED header (payment challenge)

  • A JSON body describing accepted payment options (accepts[])

Your client should:

  1. Read the payment challenge from PAYMENT-REQUIRED

  2. Create a payment that satisfies one of the accepts[] options

  3. Retry the same request with the required payment headers

Last updated