AxisTruth Documentation
HRP optimizer. Kelly sizer. Factor scorer. Stress tester. One key. Documented below.
Quickstart
curl → 200 in 60 seconds. No setup. Zero dependencies required.
API Reference
8 endpoints documented. Request schemas, response shapes, error codes, rate-limit headers.
Playbook
5 worked recipes. Rebalancing decisions, Kelly sizing, factor attribution, stress scenarios, bot integration.
What AxisTruth does
AxisTruth is a REST API for portfolio math. POST your holdings or return series; get back optimized weights, position sizes, factor exposures, or stress-test projections. The math is stateless — request bodies are processed in-memory and discarded.
5 core endpoints
| Endpoint | Purpose | Key parameters |
|---|---|---|
POST /v1/optimize-portfolio |
HRP allocation from return series | returns, assetNames, useShrinkage |
POST /v1/size-position |
Kelly criterion position sizing | expectedReturn, variance, fraction |
POST /v1/factor-score |
5-factor scoring (momentum, lowVol, quality, value) | assets, factors, lookback |
POST /v1/stress-test |
Monte Carlo stress over historical regimes | weights, dailyVols, scenarios |
GET /v1/usage |
Current-month call count vs tier limit | — |
Authentication
Every call requires a Bearer token:
Authorization: Bearer axt_live_<your-key>Missing or invalid tokens return 401. See API Reference → Authentication.
Rate limits
| Tier | Calls/month | Calls/min |
|---|---|---|
| Free | 100 | 5 |
| Pro | 50,000 | 100 |
| Enterprise | Unlimited | Custom |
Base URL
https://api.axistruth.com
API version: All endpoints are at
/v1/. The v1 contract is stable. Breaking changes will ship as /v2/ with a migration guide and a 90-day deprecation window on v1.