# Kristo Intelligence API

> AI-powered DeFi trading signals and crypto market intelligence.
> Uses the x402 payment protocol — pay with USDC on Base.

## Payment (x402 Protocol)

- Chain: Base (chain_id: 8453)
- Currency: USDC
- Token contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Receiver address: 0xd4cdA900839C0FED4374EE37EA0DBE8e4c6fd08f
- Price per API call: $0.005 USDC
- Free tier: 0 free call(s) per client, then payment required
- Monthly VIP: $29.0 USDC (unlimited for 30 days)

## How to Pay

1. Send exactly 0.005 USDC on the Base network to 0xd4cdA900839C0FED4374EE37EA0DBE8e4c6fd08f
2. Wait for on-chain confirmation (usually ~2 seconds on Base)
3. Retry the desired endpoint with the `X-Payment-Proof` header:
   `base64url(JSON({"payer": "<your wallet>", "transaction_hash": "<tx hash>", "amount_usdc": 0.005}))`
4. The server verifies the transfer on-chain and grants access automatically

For unlimited access, send 29.0 USDC for a Monthly VIP subscription.

## Endpoints

### Paid (requires x402 payment after free tier)

- GET /api/stats — Market activity and daily stats ($0.005 USDC)
- GET /api/sales — Real on-chain sales history ($0.005 USDC)
- GET /api/bot-status — Telegram bot status ($0.005 USDC)

### Free (always accessible)

- GET /.well-known/x402.json — x402 payment discovery metadata
- GET /openapi.json — OpenAPI 3.0 specification
- GET /llms.txt — This file (LLM-friendly API description)
- GET /api/mcp/manifest — MCP/x402 machine-readable manifest
- GET /health — Service health check
- GET /dashboard — HTML dashboard

## Base URL

https://kristo-intelligence-api.onrender.com

## HTTP 402 Response

When payment is required, the API returns HTTP 402 with:
- JSON body containing payment details (receiver address, amount, chain)
- Headers: X-Payment-Required, X-Payment-Address, X-Payment-Amount-USDC

## Discovery Files

- x402: https://kristo-intelligence-api.onrender.com/.well-known/x402.json
- OpenAPI: https://kristo-intelligence-api.onrender.com/openapi.json
- LLMs: https://kristo-intelligence-api.onrender.com/llms.txt
- MCP Manifest: https://kristo-intelligence-api.onrender.com/api/mcp/manifest