Skip to main content
KEPAiX
INTELLIGENCE PLATFORM
PUBLIC PROJECT
KepAIx Developer Documentation

KepAIx API
Integration Guide

Structured JSON Intelligence For Developers And AI Agents
KepAIx exposes structured, versioned educational market intelligence through documented JSON interfaces for developers, AI agents, dashboards, researchers, and educational applications. Public endpoints support discovery and testing, while premium x402 endpoints provide machine-payable access to richer intelligence. Responses are designed to communicate context, confidence, uncertainty, timestamps, versions, and limitations without exposing proprietary scoring, weighting, normalization, heuristics, or internal reasoning methods.
5-Minute AI Agent Quick Start Developer Hub

Start Here

Choose The Fastest Path Into KepAIx Use the route that matches what you are building. The Developer Hub explains the ecosystem, while this page remains the technical integration reference.
Explore The Platform Understand the free APIs, premium x402 intelligence, Publisher Program, and products developers can build. Open Developer Hub
Call A Free API Inspect live JSON without payment and begin with Market Regime, Main Brain, Liquidity Lite, or Derivatives Intelligence. Open Free JSON
Test Premium x402 Use the production browser app to connect Pera Wallet, purchase the 0.10 USDC ATLAS Premium Human Report, read the protected report, and optionally inspect the returned developer JSON. Open Reference App
Build A Publisher Business Create a branded intelligence product for your audience using KepAIx intelligence, Publisher Credits, direct visitor payments to your configured Algorand USDC address, and the private Publisher management tools. View Publisher Platform
Response FormatStructured machine-readable JSON
Public AccessFour verified free v1 JSON APIs
Premium AccessThree x402 intelligence resources
Trust ModelConfidence, uncertainty, and limitations

AI Agent Quick Start

1
Read OpenAPILoad the authoritative JSON specification at /openapi.json.
2
Read llms.txtReview the concise machine discovery map and educational boundaries.
3
Open Reference ClientInspect the production browser implementation and its complete x402 payment flow.
4
Call A Free APIStart with Market Regime or Main Brain Snapshot to inspect live JSON and preserve its context.
5
Use x402Request a premium endpoint when the client supports HTTP 402 payment flows and safe wallet signing.
Recommended First Requests
GET https://kepaix.com/api/market-regime.php
GET https://kepaix.com/api/main-brain.php
GET https://kepaix.com/api/liquidity-lite.php
GET https://kepaix.com/api/derivatives.php

Current API And Discovery Status

API Catalogv1.3.0
OpenAPI3.1.0
JSON SpecStable
YAML SpecStable
UpdatedJuly 28, 2026

Start Integrating

Verified Product DirectoryReview the four free APIs and three premium x402 resources. Response ExamplesInspect representative JSON structures from verified products. Machine DiscoveryUse OpenAPI and llms.txt resources for tools and AI agents. x402 AccessUnderstand HTTP 402 behavior, payment requirements, and settlement flow. Reference ImplementationsInspect the production browser client and complete x402 payment workflow. Main Brain SnapshotOpen the broad free public intelligence snapshot. Market RegimeOpen a focused free public market-regime response. Liquidity LiteInspect lightweight educational liquidity context. Derivatives IntelligenceInspect free derivatives-oriented educational context.

Reference Implementations

Production-Verified Developer Examples KepAIx reference implementations demonstrate how documented APIs, HTTP 402 payment requirements, wallet signing, verification, settlement, and protected JSON responses work together in real applications.

Browser Reference Implementation

A production-verified human-facing x402 purchase application deployed at /x402-buyer/. It sells the ATLAS Premium Human Report for 0.10 USDC through Pera Wallet, renders the protected intelligence as a readable report, and also allows inspection of the returned developer JSON.

Pera Wallet x402 v2
Open Browser Demo

Shared Purchase Architecture

The browser client loads the ATLAS Premium Human Report configuration, validates its HTTP 402 challenge, confirms network, asset and the exact 0.10 USDC amount, requests wallet signing, submits payment proof, and receives the protected response.

Reference Client Features

Wallet connection, session restoration, challenge decoding, exact-price validation, transaction signing, facilitator verification, settlement details, payment proof, explorer links, human-readable report rendering, Print / Save Report, optional developer JSON inspection, and error handling.

Security Boundary

KepAIx does not receive or store private keys. Pera Wallet signs the transaction, while the protected endpoint verifies payment before returning educational intelligence.

ConnectConnect Pera Wallet
HTTP 402Receive 0.10 USDC payment requirements
ApproveSign the exact USDC payment
VerifyFacilitator verifies payment
SettlePayment settles on MainNet
Read ReportReceive the protected ATLAS human report
Inspect JSONOptionally inspect the developer response
Live Reference Client
Human browser product: https://kepaix.com/x402-buyer/
Human report endpoint: https://kepaix.com/api/x402-atlas-human-report.php
Human report price: 0.10 USDC · 100000 atomic units
Human wallet: Pera Wallet

Direct developer / AI-agent x402 APIs:
Market Regime: https://kepaix.com/api/x402-market-regime.php · 0.01 USDC · 10000 atomic units
Main Brain: https://kepaix.com/api/x402-main-brain.php · 0.01 USDC · 10000 atomic units
Atlas Premium: https://kepaix.com/api/x402-atlas.php · 0.02 USDC · 20000 atomic units

Network: Algorand Mainnet
Asset: USDC · ASA 31566704
Protocol: x402 v2

What The APIs Return

Market ContextResponses may include market regime, market state, asset-level signals, and other educational context appropriate to the endpoint.
ConfidenceConfidence describes the current strength and agreement of available evidence. It is not certainty or a guaranteed future outcome.
Uncertainty & LimitsEndpoints may identify missing, mixed, unavailable, or rapidly changing evidence and provide explicit educational limitations.
Versioned StructureEndpoint identity, response type, versions, timestamps, access type, and structured fields help software interpret resources consistently.

Developer Contract

Understand
The Response
Purpose + Version + Context + Limits
Each KepAIx resource should be interpreted as an educational intelligence response, not a trading instruction. Developers should use the documented endpoint purpose, response version, timestamps, confidence, uncertainty, and limitations together rather than treating any single field as a promise of future behavior.
Integration Principle Readable By Humans. Usable By Software. Stable structures, explicit access behavior, and visible limitations reduce ambiguity for applications and AI agents.
View Endpoints View JSON

Safety & Scope

Educational OnlyKepAIx provides educational market intelligence and does not provide financial, investment, trading, tax, or legal advice.
No Guaranteed OutcomesNo signal, assessment, confidence level, historical result, or paid response guarantees future market behavior.
No Custody Or TradingKepAIx does not manage user funds, access private keys, connect to exchange accounts, or execute trades through these APIs.
Protected MethodsPublic documentation explains outputs and access behavior while proprietary formulas, weights, heuristics, normalization, and internal reasoning remain private.

Public Platform Architecture

Developers, AI Agents, Dashboards, Researchers, And Educational ApplicationsRequest structured educational market intelligence through documented resources
↓
KepAIx Public InterfacesFree discovery APIs, premium x402 APIs, documentation, OpenAPI, and llms.txt
↓
Free DiscoveryEvaluation, testing, educational use, and lightweight integrations
Premium x402Machine-payable access to richer payment-gated intelligence
Educational ExperiencesArena and related learning interfaces that consume platform intelligence
↓
Structured, Versioned JSONContext, confidence, uncertainty, evidence, timestamps, access details, and limitations where available

Human Browser Product

ATLAS Premium Human Report · 0.10 USDCHuman-facing pay-per-report access through /x402-buyer/ using Pera Wallet on Algorand MainNet.
Human Report EndpointGET https://kepaix.com/api/x402-atlas-human-report.php
PresentationThe browser renders the protected response as a plain-English ATLAS report with transaction proof, optional developer JSON inspection, and Print / Save Report support.
Separate Access PathThe 0.10 USDC human report is a distinct product path. Direct developer and AI-agent structured x402 access remains separately priced below.
Open Human Report View Direct x402 APIs

Direct Developer And AI-Agent x402 Products

Pay Per Use Instead Of Monthly Access These prices apply to direct structured x402 access for developers, AI agents, applications, and other machine-readable integrations. The separate human-facing ATLAS Premium Human Report is sold through the browser application for 0.10 USDC.
Market Regime · 0.01 USDC · Direct JSON Focused market regime, market state, confidence, risk context, summary, timestamps, and educational limitations.
Main Brain · 0.01 USDC · Direct JSON A broader paid intelligence snapshot for applications that need more market and tracked-asset context than the focused regime product.
Atlas Premium · 0.02 USDC · Direct JSON Structured synthesis across verified KepAIx intelligence layers, including summary, confidence, evidence, uncertainty, changes, and limitations.

Verified Product Categories

Main Brain Snapshot APIBroad published KepAIx snapshot with market context, confidence, tracked-asset outputs, timestamps, related resources, and limitations.
KEP-API-001v1 JSON
Market Regime APIFocused market mode, market state, confidence, risk context, summary, update time, and educational limitations.
KEP-API-002v1 JSON
Liquidity Lite APILightweight liquidity-oriented educational context with source-dependent limitations.
KEP-API-003v1 JSON
Derivatives Intelligence APIStructured derivatives-oriented educational intelligence with available context, timestamps, confidence, and limitations.
KEP-API-004v1 JSON
x402 Market Regime IntelligenceDirect structured developer and AI-agent counterpart to the free Market Regime API, unlocked through HTTP 402 and x402 v2.
0.01 USDC
x402 Main Brain IntelligenceDirect structured developer and AI-agent intelligence snapshot unlocked through HTTP 402 and x402 v2.
0.01 USDC
Atlas Premium IntelligenceDirect structured developer and AI-agent synthesis of verified KepAIx intelligence with public schema version 0.1.0.
0.02 USDCSchema 0.1.0

Verified Product Directory

Main Brain Snapshot API

Broad free public snapshot of published KepAIx intelligence.

KEP-API-001v1 JSON
GET
https://kepaix.com/api/main-brain.php

Market Regime API

Focused free public market-regime intelligence.

KEP-API-002v1 JSON
GET
https://kepaix.com/api/market-regime.php

Liquidity Lite API

Lightweight free public liquidity-oriented educational context.

KEP-API-003v1 JSON
GET
https://kepaix.com/api/liquidity-lite.php

Derivatives Intelligence API

Free public derivatives-oriented educational intelligence.

KEP-API-004v1 JSON
GET
https://kepaix.com/api/derivatives.php

x402 Market Regime Intelligence

Direct structured developer and AI-agent market-regime resource using HTTP 402 and x402 v2.

0.01 USDC
GET
https://kepaix.com/api/x402-market-regime.php

x402 Main Brain Intelligence

Direct structured developer and AI-agent intelligence snapshot using HTTP 402 and x402 v2.

0.01 USDC
GET
https://kepaix.com/api/x402-main-brain.php

Atlas Premium Intelligence

Direct structured developer and AI-agent synthesis with public schema version 0.1.0.

0.02 USDCSchema 0.1.0
GET
https://kepaix.com/api/x402-atlas.php

Canonical Product Catalog

Product Product ID Access Version Canonical Resource
Main Brain Snapshot APIKEP-API-001Free publicv1 JSON/api/main-brain.php
Market Regime APIKEP-API-002Free publicv1 JSON/api/market-regime.php
Liquidity Lite APIKEP-API-003Free publicv1 JSON/api/liquidity-lite.php
Derivatives Intelligence APIKEP-API-004Free publicv1 JSON/api/derivatives.php
x402 Market Regime IntelligenceKEP-X402-001Direct x402 JSON · 0.01 USDCx402 v2/api/x402-market-regime.php
x402 Main Brain IntelligenceKEP-X402-003Direct x402 JSON · 0.01 USDCx402 v2/api/x402-main-brain.php
Atlas Premium IntelligenceKEP-X402-002Direct x402 JSON · 0.02 USDCSchema 0.1.0/api/x402-atlas.php

What Developers Can Build

WebsitesMarket context pages and premium intelligence experiences.
Mobile AppsFocused educational intelligence for mobile users.
AI AgentsMachine-readable context for explanation and classification workflows.
DashboardsRegime, confidence, risk, evidence, and change displays.
Community BotsRequested intelligence inside Discord or Telegram workflows.
Research ToolsEducational review, journaling, and market environment comparisons.
Alert SystemsNotifications when published broad conditions change.
Publisher BusinessesBranded customer products powered by KepAIx intelligence.

Build A Publisher Business

The KepAIx Publisher Program is designed for developers, website owners, communities, and educators who want to create their own branded crypto intelligence product. Publishers can add their own interface, audience, explanations, and customer experience while KepAIx supplies the underlying educational intelligence.

Explore Publisher Platform Return To Developer Hub
Direct To Publisher During funded Publisher operation, visitor payments go directly to the Publisher’s configured Algorand USDC address. KepAIx does not custody or split Publisher sale proceeds. Shared Intelligence Credits are consumed only after successful authorized report fulfillment.

Free Discovery APIs

PurposePublic endpoints support discovery, evaluation, testing, educational use, lightweight integrations, and developer onboarding.
AccessVerified public endpoints return machine-readable JSON without a traditional account or subscription flow.
Expected UseDevelopers can inspect response structures, prototype dashboards, build educational tools, and evaluate whether premium intelligence fits a later workflow.
LimitFree access should not be interpreted as unlimited capacity, guaranteed uptime, a guaranteed future contract, or permission to abuse shared infrastructure.

Direct Premium API Intelligence

PurposePremium endpoints provide richer payment-gated educational intelligence through machine-payable access.
SustainabilityPaid access helps support the infrastructure and continued development required to maintain and improve the platform.
No Outcome GuaranteePayment unlocks a digital resource. It does not guarantee accuracy, profit, market direction, or any future outcome.
Review x402 Access Open Browser Reference

OpenAPI Discovery

Machine-Readable API Map The OpenAPI file helps developer tools, integrations, AI agents, and reviewers discover documented KepAIx paths and response shapes.
OpenAPI Resources
JSON: https://kepaix.com/openapi.json
YAML: https://kepaix.com/openapi.yaml

LLM Discovery

AI-Agent Resource Map The llms.txt file gives AI systems a concise map of KepAIx, verified public resources, premium access, canonical documentation, and educational boundaries.
Discovery Resources
LLM map: https://kepaix.com/llms.txt
Robots: https://kepaix.com/robots.txt
Sitemap: https://kepaix.com/sitemap.xml
Browser reference: https://kepaix.com/x402-buyer/

Recommended AI Integration Order

1. Market RegimeRead focused market context.
2. Main BrainRead the broader public snapshot.
3. LiquidityAdd liquidity and structure context.
4. DerivativesAdd derivatives pressure context.
5. ReasoningRequest supported-asset reasoning.
6. StatisticsInspect public network statistics.
7. x402Upgrade to paid intelligence when supported.

Agent And Tool Compatibility

Standards-Based Compatibility KepAIx uses normal HTTPS, machine-readable JSON, OpenAPI 3.1, and x402 payment behavior. Compatibility below describes intended integration patterns and does not imply a partnership, endorsement, or native product integration.
AI AssistantsTools that can retrieve HTTPS resources and interpret JSON.
Autonomous AgentsAgents capable of API discovery, structured calls, and safe error handling.
MCP And Tool ServersCustom connectors that map OpenAPI operations into callable tools.
DashboardsBrowser or server applications that consume and display JSON.
Research WorkflowsEducational analysis pipelines that preserve timestamps and limitations.
x402 ClientsClients that support HTTP 402 discovery, payment signing, verification, and settlement.
OpenAPI ToolsGenerators and explorers that support OpenAPI 3.1 documents.
Educational AppsLearning applications that present intelligence without financial-advice claims.
Browser ApplicationsProduction browser clients using Pera Wallet, HTTP 402, Algorand MainNet, and x402 v2.

Premium x402 Resources

x402 Market Regime IntelligenceGET https://kepaix.com/api/x402-market-regime.php
x402 Main Brain IntelligenceGET https://kepaix.com/api/x402-main-brain.php
Atlas Premium IntelligenceGET https://kepaix.com/api/x402-atlas.php
Unpaid BehaviorWithout valid payment, each premium resource returns HTTP 402 Payment Required with machine-readable payment requirements.

Payment Requirements

Current Verified Direct API Terms KepAIx direct developer and AI-agent endpoints use x402 v2 on Algorand Mainnet, with the exact payment amount determined by the requested structured resource. These direct API prices are separate from the 0.10 USDC human-facing ATLAS report.
Payment Details
Network: Algorand Mainnet
Asset: USDC
ASA: 31566704
Market Regime: 0.01 USDC
Market Regime atomic units: 10000
Main Brain: 0.01 USDC
Main Brain atomic units: 10000
Atlas Premium: 0.02 USDC
Atlas Premium atomic units: 20000
Protocol: x402 v2
Response: application/json

x402 Access Flow

1
RequestThe client requests the premium KepAIx resource without payment attached.
2
402 RequiredThe endpoint returns HTTP 402 and machine-readable payment requirements.
3
Client SignsThe client prepares and signs the selected product's exact Algorand USDC payment.
4
Verify & SettleThe facilitator verifies and settles the payment on Algorand Mainnet.
5
ResourceThe endpoint returns HTTP 200 with the paid educational intelligence resource.

Example Main Brain Snapshot

/api/main-brain.php
{
  "success": true,
  "endpoint": "main-brain",
  "version": "v1",
  "access": "free_public",
  "market_state": {},
  "coins": {},
  "updated": "ISO-8601 timestamp",
  "educational_only": true
}

Example Market Regime

/api/market-regime.php
{
  "success": true,
  "endpoint": "market-regime",
  "version": "v1",
  "access": "free_public",
  "market_mode": "RISK_OFF",
  "market_state": "CAUTION",
  "confidence": 46.1,
  "updated": "ISO-8601 timestamp",
  "disclaimer": "Educational information only."
}

Example Liquidity Lite

/api/liquidity-lite.php
{
  "success": true,
  "endpoint": "liquidity-lite",
  "version": "v1",
  "access": "free_public",
  "asset_count": 7,
  "assets_verified": 7,
  "limitations": [],
  "educational_only": true
}

Example Derivatives Intelligence

/api/derivatives.php
{
  "success": true,
  "endpoint": "derivatives",
  "version": "v1",
  "access": "free_public",
  "overall_state": "crowded_long_pressure",
  "overall_vote": "caution",
  "confidence": 62,
  "limitations": []
}

Example 402 Response

No Valid Payment Without valid payment, a premium endpoint returns HTTP 402 with machine-readable payment requirements.
HTTP 402
{
  "error": "Payment required",
  "project": "KepAIx",
  "endpoint": "x402-market-regime",
  "x402Version": 2,
  "message": "Payment is required before this educational intelligence resource is returned."
}

Example Atlas Response Shape

Schema-Level Illustration This example describes the public response shape without exposing protected scoring, weighting, thresholds, heuristics, prompts, or reasoning assembly.
/api/x402-atlas.php · schema 0.1.0
{
  "success": true,
  "product_id": "KEP-X402-002",
  "endpoint": "x402-atlas",
  "schema_version": "0.1.0",
  "payment_status": "settled",
  "summary": {},
  "confidence": {},
  "evidence": {},
  "limitations": [],
  "updated": "ISO-8601 timestamp",
  "educational_only": true
}

Verified Behaviors

Four Free Public APIsMain Brain Snapshot, Market Regime, Liquidity Lite, and Derivatives Intelligence return machine-readable educational JSON without x402 payment.
OpenAPI DiscoveryThe live OpenAPI resource documents the public API ecosystem and supported paths.
llms.txt DiscoveryThe live LLM resource provides AI systems with a concise map of canonical educational API resources.
HTTP 402KepAIx premium x402 endpoints return HTTP 402 when valid payment is absent or invalid.
HTTP 200 After SettlementA verified premium endpoint returns its documented resource after successful payment verification and settlement.
Production Human Report BrowserThe live browser application has completed an end-to-end 0.10 USDC ATLAS Premium Human Report purchase using Pera Wallet, Algorand MainNet USDC, facilitator verification, settlement, protected HTTP 200 delivery, human-readable report rendering, and Print / Save Report.

Settlement Proof

Successful Mainnet Tests These transaction references document successful live testing of the paid x402 endpoint, including the production browser reference implementation.
Algorand Mainnet Transactions
AURN3O6SR2ZPNUZET3MHQO5DJZBCW2H33HUWC3YZ5XCCIYNT5PBA
KHJO5UPAUBB4A2Y6RWVDONPFXAA2RW7TUQLSAFX6NWH5FI5ZIJOQ
MMHISMDJIWKIGUNNBODNBHEUQLF35BTITXPCTM7WPWKNBLF6MWKA

No-Payment Test

Expected Behavior A direct request to the premium endpoint without payment should return HTTP 402 Payment Required.
PowerShell
try {
  Invoke-WebRequest `
    -Uri "https://kepaix.com/api/x402-market-regime.php" `
    -Method GET
}
catch {
  $_.Exception.Response.StatusCode.value__
  $_.ErrorDetails.Message
}

Integration Guidance

Check The Endpoint PurposeUse each resource only for the purpose described in its documentation and visible response fields.
Read Versions And TimestampsDo not assume fields, freshness, or response contracts without checking the returned version and update information.
Handle UncertaintyApplications should preserve confidence, uncertainty, limitations, and educational disclaimers rather than discarding them.
Fail SafelyHandle non-200 responses, missing fields, unavailable data, timeouts, and schema changes without converting incomplete information into certainty.

KepAIx API Trust Contract

Educational OnlyKepAIx explains market context for learning and software integration, not financial advice.
Confidence Is Not CertaintyConfidence reports evidence strength and agreement, not a guaranteed future result.
Uncertainty Is PreservedMixed, incomplete, unavailable, or changing evidence should remain visible to downstream users.
Methods Stay ProtectedPublic APIs expose useful outputs while proprietary formulas, weights, heuristics, and reasoning implementation remain private.