# Almonax

> Verticalized intelligence platform for VC, PE, M&A, and recruiting professionals — and the AI agents acting on their behalf. Synthesizes publicly-available signals into investor-grade reports using LLM tooling over a curated corpus.

## Quick start (for agents)

1. Create an account at https://www.almonax.com (magic-link auth, no password)
2. Generate an API key at https://www.almonax.com/account/api-keys
3. Use `Authorization: Bearer ak_live_...` against /api/v1 endpoints

## Authentication

All /api/v1/* endpoints require:
  Authorization: Bearer ak_live_<your-key>

Optional:
  Idempotency-Key: <unique-string>      # safe-replay POST requests (24h cache)

## Endpoints

### GET /api/v1/balance
Returns: { "balance": <int>, "currency": "credits" }

### POST /api/v1/reports
Generate a new report. Body:
  {
    "type": "quick_scan|standard|premium|role_map|jd_optimizer|org_snapshot|acquihire_candidates|competitive_talent_brief|exit_radar|fund_tracker|risk_pulse",
    "topic": "<5-2000 char research prompt>",
    "filters": <optional object>
  }
Returns: { "id": "<uuid>", "status": "queued", "credits_spent": <int>, "poll_url": "/api/v1/reports/<id>" }

### GET /api/v1/reports/{id}
Poll for completion. Returns:
  { "id", "type", "status": "queued|running|complete|failed", "topic", "title", "content_md", "summary_md", "credits_spent", "created_at" }
Poll every 5-15 seconds; reports complete in 30-90 seconds.

## Pricing

1 credit = $0.10. Reports priced per type (see /api/v1/pricing for current rate card).
Buy credits at https://www.almonax.com/account (purchase $20-$500; +5% bonus at $200+).
Agent rate = human rate (no discrimination).

## Errors

All errors return JSON:
  { "error": "<message>", "detail": "<optional>" }

Standard HTTP semantics:
  401 invalid/missing API key
  402 insufficient credits (recharge at /account)
  422 validation
  500 internal

## Other agent surfaces

- MCP server: `npm install -g @almonax/mcp` — 5 tools, stdio transport. See https://www.almonax.com/docs/agent
- x402 endpoint: POST /api/x402/run-report (HTTP 402 + USDC quote scaffold; verification gated on Phase 3)
- OpenAPI 3.1 spec: /openapi.json
- Agent docs: /docs/agent
- robots.txt: /robots.txt

## Contact

hello@almonax.com