KepAIx Market Regime API documentation.
The KepAIx Market Regime API is a paid educational JSON endpoint that uses x402 payments on Algorand Mainnet. Clients receive HTTP 402 payment requirements, submit a valid USDC payment, and receive KepAIx Main Brain market regime data after settlement.
What the API returns.
The current paid endpoint returns a KepAIx Main Brain educational market regime snapshot. It is designed for developers, AI agents, data tools, and applications that need simple pay-per-request access to current market context.
Market Mode
Returns the current high-level environment reading, such as risk-on, risk-off, or unknown if no current snapshot is available.
Market State
Returns a simplified plain-English condition such as caution, wait, or opportunity for educational context.
Risk & Confidence
Returns confidence and risk score fields from the KepAIx Main Brain public snapshot where available.
Live Endpoint
Send a GET request to the endpoint below. Without payment, the endpoint returns HTTP 402 Payment Required and includes x402 payment requirements.
https://kepaix.com/api/x402-market-regime.php
Payment Requirements
The endpoint uses exact x402 payment requirements on Algorand Mainnet. The current live price is 0.01 USDC, represented as 10000 atomic units because Algorand USDC uses 6 decimals.
Network: Algorand Mainnet Asset: USDC ASA 31566704 Price: 0.01 USDC Atomic amount: 10000 Scheme: exact Response: application/json
How access works.
KepAIx uses the HTTP 402 payment flow so a client or autonomous agent can discover the price, submit payment, and receive the paid resource without subscriptions, accounts, or API keys.
Example 402 Response
If the request does not include a valid payment, the API returns HTTP 402 with payment instructions.
{
"error": "Payment required",
"project": "KepAIx",
"endpoint": "x402-market-regime",
"type": "paid_educational_market_regime",
"x402Version": 2,
"message": "This KepAIx endpoint requires an x402 payment before market regime data is returned."
}
Example Paid Response
After a valid payment is verified and settled, the API returns HTTP 200 with the paid resource.
{
"project": "KepAIx",
"endpoint": "x402-market-regime",
"type": "paid_educational_market_regime",
"payment_status": "settled",
"market_mode": "RISK_OFF",
"market_state": "CAUTION",
"confidence": 46.1,
"risk_score": 66.7,
"source": "KepAIx Main Brain public snapshot"
}
Basic request behavior.
Developers can test the endpoint by requesting it directly. A direct request without payment should return HTTP 402. A properly configured x402 client can then complete payment and receive HTTP 200.
No-Payment Test
Expected result: HTTP 402 Payment Required.
try {
Invoke-WebRequest `
-Uri "https://kepaix.com/api/x402-market-regime.php" `
-Method GET
}
catch {
$_.Exception.Response.StatusCode.value__
$_.ErrorDetails.Message
}
Invalid Payment Test
Expected result: HTTP 402 Payment Required.
try {
Invoke-WebRequest `
-Uri "https://kepaix.com/api/x402-market-regime.php" `
-Headers @{ "X-PAYMENT" = "bad-test" } `
-Method GET
}
catch {
$_.Exception.Response.StatusCode.value__
$_.ErrorDetails.Message
}
Mainnet payment validation.
The KepAIx x402 endpoint has been validated with real Algorand Mainnet payments. The validation confirmed that unpaid requests return 402, invalid payment requests return 402, and valid settled payments return HTTP 200 with the paid resource.
AURN3O6SR2ZPNUZET3MHQO5DJZBCW2H33HUWC3YZ5XCCIYNT5PBA KHJO5UPAUBB4A2Y6RWVDONPFXAA2RW7TUQLSAFX6NWH5FI5ZIJOQ
Live API
Market Regime API is live and returns paid educational market regime JSON through x402 payments.
Future Endpoints
Potential future APIs may include risk score snapshots, asset sentiment summaries, portfolio snapshots, and learning metric endpoints.
Agent Access
The x402 model allows software clients and AI agents to discover a price, pay per request, and consume a digital resource programmatically.
Use KepAIx as a paid x402 market intelligence endpoint.
The live endpoint demonstrates a complete pay-per-request flow on Algorand Mainnet: 402 Payment Required, signed payment, facilitator verification, settlement, and paid JSON resource delivery.