What does the KepAIx API provide?

KepAIx provides structured educational market intelligence through JSON endpoints that may include market regime context, signals, liquidity context, derivatives context, confidence, uncertainty, evidence, timestamps, versions, and explicit limitations.

Which KepAIx APIs are free?

KepAIx provides public discovery endpoints for evaluation, testing, educational use, and lightweight integrations. The verified free products are the Main Brain Snapshot API, Market Regime API, Liquidity Lite API, and Derivatives Intelligence API.

What happens without payment on an x402 endpoint?

A request to a KepAIx payment-gated x402 endpoint without valid payment returns HTTP 402 Payment Required with payment instructions.

KepAIx Developer Documentation

KepAIx API
Integration Guide

Q: Is KepAIx financial advice?

No. KepAIx provides educational market intelligence and does not provide financial, investment, trading, tax, or legal advice.

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.

Response FormatStructured machine-readable JSON

Public AccessFour verified free v1 JSON APIs

Premium AccessTwo verified x402 resources

Trust ModelConfidence, uncertainty, and limitations

AI Agent Quick Start

Read OpenAPILoad the authoritative JSON specification at /openapi.json.

Read llms.txtReview the concise machine discovery map and educational boundaries.

Browse MarketplaceExplore the production browser marketplace and its verified multi-product x402 purchase flow.

Call A Free APIStart with Market Regime or Main Brain Snapshot to inspect live JSON and preserve its context.

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.1.0

OpenAPI3.1.0

JSON SpecStable

YAML SpecStable

UpdatedJuly 15, 2026

Start Integrating

Verified Product DirectoryReview the four free APIs and two 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.

Production Browser Marketplace

A production-verified, multi-product browser-native x402 marketplace deployed at /x402-buyer/. It supports Market Regime and Atlas Premium through one shared purchase engine.

Production Verified Pera Wallet x402 v2

Open Browser Demo

Shared Purchase Architecture

The client loads the selected product configuration, validates its HTTP 402 challenge, confirms network, asset and exact amount, requests wallet signing, submits payment proof, and receives the selected protected response.

Reference Client Features

Product selection, wallet connection, session restoration, challenge decoding, exact-price validation, transaction signing, facilitator verification, settlement details, payment proof, explorer links, 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.

SelectChoose Market Regime or Atlas

WalletConnect Pera Wallet

HTTP 402Receive payment requirements

ApproveSign the exact USDC payment

VerifyFacilitator verifies payment

SettlePayment settles on MainNet

Protected JSONReceive live KepAIx intelligence

Live Reference Client

Browser marketplace: https://kepaix.com/x402-buyer/
Market Regime: https://kepaix.com/api/x402-market-regime.php
Atlas Premium: https://kepaix.com/api/x402-atlas.php
Wallet: Pera Wallet
Network: Algorand Mainnet
Asset: USDC · ASA 31566704
Market Regime price: 0.01 USDC · 10000 atomic units
Atlas Premium price: 0.02 USDC · 20000 atomic units
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.

Understanding KepAIx Responses

Understand
The Response

Purpose + Version + Context + Limits

Each KepAIx resource should be interpreted as an educational intelligence response, not a trading instruction. Each KepAIx response includes its documented purpose, version, timestamps, confidence, uncertainty, and limitations so software and AI agents can interpret the resource within its intended educational context. Individual fields are intended to be evaluated together rather than treated as guarantees of future market behavior.

Integration Principle Designed For Reliable Integration Stable response structures, explicit versioning, and transparent limitations help developers, applications, and AI agents integrate KepAIx resources consistently.

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

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 IntelligencePremium counterpart to the free Market Regime API, unlocked through HTTP 402 and x402 v2.

KEP-X402-0010.01 USDC

Atlas Premium IntelligencePremium structured synthesis of verified KepAIx intelligence with public schema version 0.1.0.

KEP-X402-0020.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

Premium market-regime resource using HTTP 402 and x402 v2.

KEP-X402-0010.01 USDC

GET

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

Atlas Premium Intelligence

Premium structured synthesis with public schema version 0.1.0.

KEP-X402-0020.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 API	KEP-API-001	Free public	v1 JSON	/api/main-brain.php
Market Regime API	KEP-API-002	Free public	v1 JSON	/api/market-regime.php
Liquidity Lite API	KEP-API-003	Free public	v1 JSON	/api/liquidity-lite.php
Derivatives Intelligence API	KEP-API-004	Free public	v1 JSON	/api/derivatives.php
x402 Market Regime Intelligence	KEP-X402-001	Paid x402 · 0.01 USDC	x402 v2	/api/x402-market-regime.php
Atlas Premium Intelligence	KEP-X402-002	Paid x402 · 0.02 USDC	Schema 0.1.0	/api/x402-atlas.php

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 UsePublic discovery resources support evaluation, educational applications, dashboards, research workflows, prototypes, and software integration before premium resources are required.

LimitFree access should not be interpreted as unlimited capacity, guaranteed uptime, a guaranteed future contract, or permission to abuse shared infrastructure.

Premium Intelligence

PurposePremium endpoints provide richer payment-gated educational intelligence through machine-payable access.

Access ModelPremium resources are protected by HTTP 402 and x402. Successful payment verification unlocks structured educational intelligence for supported clients.

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

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 Terms Both verified premium endpoints use x402 v2 on Algorand Mainnet, with the exact payment amount determined by the selected product.

Payment Details

Network: Algorand Mainnet
Asset: USDC
ASA: 31566704
Market Regime: 0.01 USDC
Market Regime atomic units: 10000
Atlas Premium: 0.02 USDC
Atlas Premium atomic units: 20000
Protocol: x402 v2
Response: application/json

x402 Access Flow

RequestThe client requests the premium KepAIx resource without payment attached.

402 RequiredThe endpoint returns HTTP 402 and machine-readable payment requirements.

Client SignsThe client prepares and signs the selected product's exact Algorand USDC payment.

Verify & SettleThe facilitator verifies and settles the payment on Algorand Mainnet.

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 402Both verified 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 Multi-Product BrowserThe live browser marketplace has completed end-to-end Market Regime and Atlas Premium purchases using Pera Wallet, Algorand MainNet USDC, facilitator verification, settlement, and protected HTTP 200 JSON responses.

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 UncertaintyConfidence, uncertainty, timestamps, educational boundaries, and documented limitations are included to support responsible interpretation by downstream software and AI agents.

Fail SafelyHandle non-200 responses, missing fields, unavailable data, timeouts, and schema changes without converting incomplete information into certainty.

Platform Principles

Educational IntelligenceKepAIx publishes structured educational intelligence for learning, research, software integration, dashboards, and AI agents.

Structured ResponsesEvery published resource uses documented, versioned JSON designed for reliable consumption by applications and AI systems.

Transparent ContextResponses may include confidence, timestamps, uncertainty, limitations, and supporting context so downstream software can preserve important information.

Protected ImplementationPublic documentation explains each resource and its response contract while proprietary implementation methods remain private.

KepAIx APIIntegration Guide