For developers & AI agents

Build on Fahali.

Real-time market-risk intelligence, callable from any AI agent, script, or application. Free developer key gets you started in minutes.

MCP

Connect Claude, Cursor, ChatGPT, and other MCP-compatible agents to Fahali's detection engines. Four tools: market verdict, portfolio risk, contagion map, capital flow.

SSE: mcp.fahaliai.com/sse

MCP server docs →

REST API

Full OpenAPI spec with endpoints for market verdicts, portfolio risk, contagion, capital flow, and published intel. Auth via Bearer token.

OpenAPI spec →

AI discoverable

llms.txt, llms-full.txt, and a full reference corpus on both domains. Answer engines read and cite Fahali accurately.

llms.txt →

Get a free developer key

The free tier includes the fahali_get_market_verdict tool with 50 calls/day — enough to evaluate the intelligence or build a prototype.

Request your key

Email us and we'll issue a key within one business day. Include your intended use case and expected call volume for the right tier.

Request via email →

Existing subscribers: your subscription includes API access at Professional tier and above — no separate key needed.

Quick start

Call the market verdict endpoint with curl — no key required to test the structure.

curl https://app.fahaliai.com/api/public/stats

With an API key:

curl -H "Authorization: Bearer sk_live_your_key" \
  "https://app.fahaliai.com/api/agent/market-verdict?symbol=BTC"

MCP integration

Add Fahali to any MCP-compatible agent in two lines.

Claude Desktop config:

{
  "mcpServers": {
    "fahali": {
      "command": "node",
      "args": ["/path/to/fahali-mcp/dist/index.js", "--stdio"],
      "env": { "FAHALI_API_KEY": "sk_live_..." }
    }
  }
}

SSE (cloud agents):

SSE endpoint: https://mcp.fahaliai.com/sse
Auth: Authorization: Bearer sk_live_...
Tools: fahali_get_market_verdict · fahali_get_portfolio_risk
       fahali_get_contagion_map · fahali_get_capital_flow

API endpoints

GET /api/public/stats Public market stats — no auth

GET /api/market/movers Top 25 symbols by detection activity (24h) — no auth

GET /api/institutional/signals?symbol=BTCUSDT&limit=5 Recent detections per symbol — free tier (50/day)

GET /api/agent/market-verdict?symbol=BTC Structured verdict per symbol — free tier

GET /api/agent/portfolio-risk Portfolio risk score, VaR, drawdown — Professional+

GET /api/agent/contagion-map Cross-asset contagion graph — Elite+

GET /api/agent/capital-flow?symbol=BTC Net flow, institutional vs retail — Professional+

GET /api/intel/posts Published intel posts — no auth

GET /api/track-record/scorecard Live accuracy scorecard — no auth

Pricing by tier

Free developer key: fahali_get_market_verdict only, 50 calls/day

Professional ($79/mo): REST API access + capital flow

Elite ($299/mo): Full API + contagion map + portfolio risk

Desk ($1,499/mo): Team access up to 10 seats

Enterprise ($4,999/mo): Unlimited seats + MCP integration + dedicated VPC

Start a trial →