Get started

Quickstart

Send a finance task through Alpha Router using one stateless, Responses-style API.

Build with an agent

Integrate Alpha Router into my application using https://router.intelligentalpha.co/SKILL.md

Create an API key

Open the console, create a user API key, and store it in your environment. Your key is shown once and can be revoked at any time.

Keep keys server-side

Never expose an Alpha Router API key in browser or mobile application code.

.env.local

ALPHA_ROUTER_API_KEY=iar_live_••••••••••••••••

Send your first request

Include the full context and a finance-task classification. The model identifier remains stable while routing changes behind the scenes.

TypeScript

route.ts

import { AlphaRouter } from "@intelligent-alpha/router";

const alphaRouter = new AlphaRouter({
  apiKey: process.env.ALPHA_ROUTER_API_KEY,
});

const response = await alphaRouter.responses.create({
  input: "Summarize the earnings quality and key risks.",
  routing: { finance_task: "earnings_analysis" },
});

Python

route.py

from alpha_router import AlphaRouter

client = AlphaRouter(api_key=os.environ["ALPHA_ROUTER_API_KEY"])

response = client.responses.create(
    input="Summarize the earnings quality and key risks.",
    routing={"finance_task": "earnings_analysis"},
)

cURL

terminal

curl https://api.router.intelligentalpha.co/v1/responses \
  -H "Authorization: Bearer $ALPHA_ROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "intelligent-alpha/finance",
    "input": "Summarize the earnings quality and key risks.",
    "routing": { "finance_task": "earnings_analysis" }
  }'

Classify the finance task

In v0, every request supplies routing.finance_task. Use general_finance when no specialized category applies.

Task	Value	Use when
General finance	`general_finance`	The safe default for financial work that does not fit a specialized task.
Earnings analysis	`earnings_analysis`	Extract the signal in reported results, guidance, and management commentary.
Equity research	`equity_research`	Synthesize company, industry, and market evidence into a research answer.
Portfolio analysis	`portfolio_analysis`	Reason about exposures, trade-offs, and portfolio-level outcomes.

Understand the contract

Stateless only

Send the full conversation on every request. Server-side conversation state is off.

Model-neutral responses

Provider and final model identity remain internal to Alpha Router.

Exact credit ledger

Usage is metered and debited after a request reaches a billable terminal state.

Safe failure

Errors use a stable public envelope without leaking provider diagnostics.

Unsupported stateful fields are rejected

Requests with store: true or a non-null previous_response_id receive an HTTP 400 response.

Explore the API contract

Review the generated request schemas and public error model.

API reference