Docs
Public API and webhook reference.
The public API is intentionally narrow. It exists to expose the live proof feed, per-proof detail, performance aggregation, and subscription-ready webhook payloads without pretending to be a full institutional market-data terminal.
Integrity-verified signalsLosses publicly trackedNo post-publication edits
API overview
Public endpoints are read-only and designed around trust surfaces: recent signals, immutable proof detail, and public performance. Responses can honestly report demo or collecting states when real tracked data is not available.
No auth requiredJSON onlyBackward-compatible additive fields
GET /api/signals
Returns the public radar feed, including verification, integrity, live state, and outcome classification fields.
Example request
curl https://kahramana.io/api/signals
Example response
{
"generatedAt": "2026-04-05T12:57:00.177Z",
"source": "real",
"fallbackUsed": false,
"items": [
{
"id": "radar_b198af056f7f",
"verificationId": "proof_6892639881a0ba91",
"tokenOrPair": "7AHS…/SOL",
"baseAsset": {
"symbol": "7AHS…",
"address": "7AHSA6sE5HRzs8owssL9re18RHQQh6Wb7XSWqCUegWk3"
},
"quoteAsset": {
"symbol": "SOL",
"address": "So11111111111111111111111111111111111111112"
},
"chain": "solana",
"venue": "solana-launch-radar",
"detectedAt": "2026-04-05T12:56:46.000Z",
"publishedAt": "2026-04-05T12:57:00.041Z",
"detectedAtLabel": "Apr 5, 12:56 PM UTC",
"publishedAtLabel": "Apr 5, 12:57 PM UTC",
"liquidityUsd": 16.88,
"overallScore": 49.37,
"priceChange5mPct": 0,
"priceChange15mPct": 0,
"volumeSpikeRatio": 0,
"recentMovementWindow": "15m",
"rationale": "7AHS…/SOL stays in watch because current evidence is incomplete for strategy promotion.",
"supportPosture": "signal_only",
"supportSummary": "Solana paper execution is available while live execution remains disabled.",
"outcomeSnapshots": [],
"badges": [
"signal_only"
],
"dataSource": "real",
"sourceType": "real",
"integrityStatus": "verified",
"contentHash": "60b898de1e4a3bb280126b9a0d4996f9addd3895c7d6f7cbae78e5b3d363385f",
"hashVersion": "v1",
"classification": "pending",
"classificationWindow": null,
"liveState": "tracking_now",
"bestReturnPct": null,
"worstReturnPct": null,
"latestReturnPct": null,
"decisionImpact": {
"avoidedLossFlag": false,
"avoidedLossPct": null,
"capturedMoveFlag": false,
"capturedMovePct": null,
"cautionSignalFlag": false,
"blockedProtectionFlag": false,
"impactSummaryLabel": "Tracking now",
"impactSummaryText": "The setup is published and being tracked, but the full decision impact is still forming."
},
"priorityScore": 71,
"priorityLabel": "medium",
"priorityReason": "Live tracking is active, but confirmation quality is still mixed and needs reinforcement.",
"freshnessState": "fresh",
"freshnessUpdatedAt": "2026-04-05T12:56:51.304Z",
"runtimeProviderMode": "live",
"signalMaturationState": null,
"signalWhyNow": null,
"signalWhatToWatchNext": null,
"signalUncertaintyLine": null,
"signalTier": null,
"signalDeliveredAt": null,
"signalPromotionBlockers": [],
"signalLanes": [],
"walletBacked": false,
"evmAlphaSummary": null,
"publicContentMode": null,
"firstPrivateAudience": null,
"firstPrivateDeliveredAt": null,
"publicRevealStatus": null,
"publicRevealWhatChanged": null,
"publicRevealWhatHappenedSince": null,
"publicRevealDeltaPct": null,
"publicRevealPeakMovePct": null,
"publicRevealPerformanceLine": null,
"proofHeadline": "7AHS…/SOL launch radar signal",
"proofFraming": "This was detected at Apr 5, 12:56 PM UTC before the outcome.",
"supportExplanation": "The opportunity can still be reviewed, but the current path stops before execution.",
"guardrails": [
{
"guardrailType": "score_below_threshold",
"severity": "warning",
"reason": "Overall conviction did not clear the current decision threshold.",
"detectedValue": null,
"requiredValue": null,
"thresholdLabel": "Detected value"
},
{
"guardrailType": "insufficient_liquidity",
"severity": "warning",
"reason": "Observed liquidity is below the launch-routing minimum.",
"detectedValue": "$17",
"requiredValue": null,
"thresholdLabel": "Detected value"
}
],
"rationaleSections": [
{
"title": "Why this mattered",
"summary": "The score mix indicates how much structural quality, risk, and momentum support this setup has right now."
},
{
"title": "Decision reasoning",
"summary": "Decision=watch with structural=34, risk=66, momentum=77.92; promotion requires cleaner reinforcement."
},
{
"title": "Risk context",
"summary": "Risk and control layers are shaping whether this setup can move forward."
},
{
"title": "Strategy posture",
"summary": "No strategy recommendation is attached yet."
}
],
"integrity": {
"verificationId": "proof_6892639881a0ba91",
"publishedAt": "2026-04-05T12:57:00.041Z",
"contentHash": "60b898de1e4a3bb280126b9a0d4996f9addd3895c7d6f7cbae78e5b3d363385f",
"hashVersion": "v1",
"status": "verified",
"isLocked": true,
"lockedAt": "2026-04-05T12:57:00.041Z",
"lockReason": "public_publish"
},
"outcomeSummary": {
"classification": "pending",
"bestReturnPct": null,
"worstReturnPct": null,
"latestReturnPct": null,
"classificationWindow": null,
"explanation": "Outcome tracking is still in progress. Later checkpoints have not completed yet.",
"completeCheckpointCount": 0,
"pendingCheckpointCount": 4
},
"pair": "7AHS…/SOL",
"venueName": "solana-launch-radar",
"sourceBucket": "solana",
"isSurfacedSignal": false,
"surfacedDeliveredAt": null
}
]
}GET /api/proof/:id
Returns the immutable public proof record for a specific published item, including integrity state, outcome summary, and decision-impact summary.
Example request
curl https://kahramana.io/api/proof/radar_b198af056f7f
Example response
{
"id": "radar_b198af056f7f",
"verificationId": "proof_6892639881a0ba91",
"integrity": {
"verificationId": "proof_6892639881a0ba91",
"publishedAt": "2026-04-05T12:57:00.041Z",
"contentHash": "60b898de1e4a3bb280126b9a0d4996f9addd3895c7d6f7cbae78e5b3d363385f",
"hashVersion": "v1",
"status": "verified",
"isLocked": true,
"lockedAt": "2026-04-05T12:57:00.041Z",
"lockReason": "public_publish"
},
"classification": "pending",
"liveState": "tracking_now",
"decisionImpact": {
"avoidedLossFlag": false,
"avoidedLossPct": null,
"capturedMoveFlag": false,
"capturedMovePct": null,
"cautionSignalFlag": false,
"blockedProtectionFlag": false,
"impactSummaryLabel": "Tracking now",
"impactSummaryText": "The setup is published and being tracked, but the full decision impact is still forming."
},
"outcomeSnapshots": []
}GET /api/performance
Returns aggregated public proof outcomes. The page remains explicit when the dataset is still collecting or when decision-impact summaries are not yet available.
Example request
curl https://kahramana.io/api/performance?range=30d
Example response
{
"generatedAt": "2026-04-05T12:57:00.411Z",
"source": "real",
"range": "30d",
"collecting": false,
"summary": {
"totalSignalsTracked": 5000,
"wins": 0,
"losses": 0,
"neutral": 541,
"pending": 4136,
"insufficientData": 323,
"winRate": 0,
"lossRate": 0,
"neutralRate": 0.1082,
"pendingRate": 0.8272,
"insufficientDataRate": 0.0646,
"averageMoveUp": 0.26,
"averageMoveDown": null
},
"impactSummary": {
"blockedProtectedCount": 0,
"favorableFollowThroughCount": 0,
"cautionarySetupCount": 541,
"stillPendingCount": 4136,
"available": true
}
}Webhook events
The subscription surface currently supports three event types: signal_created, outcome_updated, and proof_integrity_warning. Delivery infrastructure stays intentionally narrow. The payloads below are the stable event shapes exposed today.
Subscribe
curl -X POST https://kahramana.io/api/webhooks/subscribe \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/webhooks/kahramana","eventType":"signal_created"}'signal_created
{
"eventType": "signal_created",
"generatedAt": "2026-04-05T12:57:00.412Z",
"payload": {
"proofId": "radar_b198af056f7f",
"verificationId": "proof_6892639881a0ba91",
"detectedAt": "2026-04-05T12:56:46.000Z",
"tokenOrPair": "7AHS…/SOL",
"posture": "signal_only",
"score": 49.37
}
}outcome_updated
{
"eventType": "outcome_updated",
"generatedAt": "2026-04-05T12:57:00.412Z",
"payload": {
"proofId": "radar_b198af056f7f",
"verificationId": "proof_6892639881a0ba91",
"classification": "pending",
"classificationWindow": null,
"latestReturnPct": null,
"liveState": "tracking_now"
}
}proof_integrity_warning
{
"eventType": "proof_integrity_warning",
"generatedAt": "2026-04-05T12:57:00.412Z",
"payload": {
"proofId": "radar_b198af056f7f",
"verificationId": "proof_6892639881a0ba91",
"integrityStatus": "verified",
"publishedAt": "2026-04-05T12:57:00.041Z"
}
}