Assets

Token-specific narratives and metrics

Asset snapshot (v1)

get

Path parameters

symbolstring · max: 24Required

Asset symbol or ticker (case-insensitive).

Pattern: ^[A-Za-z0-9:_-]+$

Responses

200

Asset snapshot payload.

application/json

402

Payment required (x402). This endpoint is paywalled. On a 402, read the payment challenge from PAYMENT-REQUIRED (legacy: X-PAYMENT-REQUIRED), complete payment, then retry the same request.

application/json

404

Unsupported asset symbol.

application/json

503

Snapshot not ready.

application/json

get

/v1/snapshot/asset/{symbol}

HTTPcURLJavaScriptPython

GET /v1/snapshot/asset/{symbol} HTTP/1.1
Host: sentiment-api.kytona.com
Accept: */*

{
  "schemaVersion": "2025-01-01",
  "generatedAt": "2025-02-18T12:00:00.000Z",
  "symbol": "BTC",
  "narratives": [
    {
      "headline": "Spot demand steady",
      "stance": "constructive"
    }
  ],
  "correlationLayer": {
    "status": "tracking",
    "correlationIndex": 71
  },
  "marketMovement": {
    "label": "up",
    "reason": "Momentum building",
    "confidence": 0.63
  }
}

Asset snapshot (v2)

get

Path parameters

symbolstring · max: 24Required

Asset symbol or ticker (case-insensitive).

Pattern: ^[A-Za-z0-9:_-]+$

Responses

200

Asset snapshot payload.

application/json

402

Payment required (x402). This endpoint is paywalled. On a 402, read the payment challenge from PAYMENT-REQUIRED (legacy: X-PAYMENT-REQUIRED), complete payment, then retry the same request.

application/json

404

Unsupported asset symbol.

application/json

503

Snapshot not ready.

application/json

get

/v2/snapshot/asset/{symbol}

HTTPcURLJavaScriptPython

GET /v2/snapshot/asset/{symbol} HTTP/1.1
Host: sentiment-api.kytona.com
Accept: */*

{
  "schemaVersion": "2025-01-01",
  "generatedAt": "2025-02-18T12:00:00.000Z",
  "symbol": "BTC",
  "narratives": [
    {
      "headline": "Spot demand steady",
      "stance": "constructive"
    }
  ],
  "correlationLayer": {
    "status": "tracking",
    "correlationIndex": 71
  },
  "marketMovement": {
    "label": "up",
    "reason": "Momentum building",
    "confidence": 0.63
  }
}