Agent API v1 · live now · read-only

Give your agent forecasts it can cite and verify.

Timestamped IA1, IA2 and IA3 outputs across 195 symbols active in the last 24 hours. Start with a no-key demo, then use the free delayed tier. No card and no human approval.

Create free API key Read OpenAPI

120 req/hour free15-minute delayAttribution required

Typed response · abbreviated

{
  "symbol": "BTC/USD",
  "predictions": {
    "15min": {
      "horizon_min": 90,
      "ia1": { "score": 54.2 },
      "ia2": { "predicted_change_pct": 0.18 },
      "ia3": { "direction": "long", "p_long": 0.53 }
    }
  },
  "meta": {
    "source": "Avaltix (avaltix.io)",
    "disclaimer": "Probabilistic market data. Not financial advice."
  }
}

RESTcanonical /api/agent/v1

MCPpublic evidence tools

165k+timestamped forecasts

163k+settled outcomes

Quickstart

From discovery to useful data in three calls.

The demo proves connectivity and schema without registration. A free key unlocks the current symbol universe with a 15-minute data delay.

Try the schema

No key. Three liquid demo symbols. Sixty-minute delay.

curl 'https://avaltix.io/api/agent/v1/demo.php?symbol=BTC/USD'

Create a free key

The secret is returned once; Avaltix stores only its SHA-256 hash.

Call a forecast

Use the key as a Bearer token. Responses carry data age, attribution and disclaimer metadata.

curl -H 'Authorization: Bearer YOUR_KEY' \
 'https://avaltix.io/api/agent/v1/predictions.php?symbol=BTC/USD'

Canonical surface

One contract. No route guessing.

Older command-gateway documentation is deprecated. New integrations should use only the routes below and the linked OpenAPI document.

Method	Path	Auth	Purpose
GET	`/api/agent/v1/demo.php`	Public	Delayed live schema demo
POST	`/api/agent/v1/register.php`	Public	Create a free key
GET	`/api/agent/v1/predictions.php`	Bearer	Latest forecasts and optional candles
GET	`/api/agent/v1/symbols.php`	Bearer	Universe and freshness
GET	`/api/agent/v1/track-record.php`	Public	Current-protocol evidence
GET	`/api/agent/v1/verify.php`	Public	Audit one expired prediction

Model Context Protocol

Public evidence tools over Streamable HTTP.

The MCP endpoint is stateless and unauthenticated because it exposes only delayed demo and public evidence tools. Full-universe access stays on REST until OAuth 2.1 is available.

MCP endpoint

https://avaltix.io/mcp/

4Read-only toolsavaltix_demo_prediction
avaltix_track_record
avaltix_verify_prediction
avaltix_capabilities

Usage contract

Rules an agent can apply without interpretation.

Cite the source

Free responses require: “Avaltix (avaltix.io)”. Preserve forecast timestamp, symbol and horizon.

Carry uncertainty

Never turn probabilities into guarantees. When citing performance, include n, cohort start, confidence interval and maturity.

Keep execution separate

The Agent API and MCP are read-only. Avaltix does not place orders and its output is not financial advice.

Start with data, then decide if Avaltix belongs in the workflow.

No pitch is a substitute for a response your agent can inspect. Run the public demo, read the current cohort and verify individual outcomes.

Run demo Inspect track record