SovereignAI

API Reference

Integrate Solana DeFi intelligence into your app. Token risk analysis, AI trading signals, and swap routes powered by our fine-tuned model.

Swap API — Base URL

https://sovereigntokenswap.xyz/api/v1

Inference API — Base URL

https://b0d77eb5ed8fcf.lhr.life

Direct access to sovereign-v2:latest · /predict · /analyze · /sentiment

Endpoints

GET/signalPublic

Get an AI-powered trading signal (bullish / bearish / neutral) for any Solana token. Powered by SovereignAI's fine-tuned DeFi model.

Parameters

mintstringrequiredSolana token mint address (base58)

symbolstringoptionalToken ticker for display (e.g. SOL)

Request

GET /api/v1/signal
  ?mint=So11111111111...112
  &symbol=SOL

Response

{
  "signal": "bullish",
  "confidence": 72,
  "reason": "Strong momentum with high validator activity",
  "token": "SOL",
  "aiPowered": true,
  "ts": 1713196800000
}

POST/analyzeAPI Key

Deep token/protocol analysis powered by sovereign-v2. Free-form DeFi questions with on-chain context. Requires API key.

Parameters

tokenstringoptionalSolana mint address for risk analysis

questionstringoptionalFree-form DeFi/crypto question (max 500 chars)

Request

POST https://sovereigntokenswap.xyz/api/v1/analyze
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "token": "So11111111111111111111111111111111111111112",
  "question": "What are the key risks for SOL in Q2 2026?"
}

Response

{
  "analysis": "Key risks: validator concentration with top 20 controlling 40%+ of stake, Firedancer rollout delays, macro BTC correlation...",
  "model": "sovereign-v2:latest",
  "token": "So111...112",
  "timestamp": "2026-04-16T15:40:00Z"
}

GET/statusPublic

Live datacenter status: GPU utilization, training progress, bot PnL, and system health.

Request

GET /api/v1/status

Response

{
  "training": { "aRate": 61, "model": "v42", "progress": "6626/2000" },
  "bot": { "status": "idle", "trades": 0, "winRate": 0, "pnl": 0 },
  "wallet": { "balance": 3.59, "unit": "mSOL" },
  "health": 90
}