api.spokenalpha.com

Getting started

From signup to first successful response in under five minutes.

Sign up and get a key

Go to /pricing and sign up for the Free tier — no credit card required. After email verification, your API key is available in the dashboard under Account → API keys.

Key format

sa_live_<32 characters>

Shown once at creation — copy it immediately. Store it as SPOKEN_ALPHA_API_KEY in your environment, not in source code. The samples below use YOUR_API_KEY as a placeholder — swap in your real key from the account dashboard.

Find the most recent AAPL call

Call IDs follow the format call_{TICKER}_{YYYY}Q{Q}_earnings. The quickest way to get the current one is the earnings-calls list endpoint (Free tier, live today):

# Step 1: list recent AAPL calls to find the current call_id
export SPOKEN_ALPHA_API_KEY="YOUR_API_KEY"
curl "https://api.spokenalpha.com/v1/companies/AAPL/earnings-calls?limit=1" \
  -H "Authorization: Bearer $SPOKEN_ALPHA_API_KEY"

The id field in the first result is your call_id.

Fetch the language analysis

Pass the call_id to the analysis endpoint:

# Step 2: fetch the language analysis for that call
curl "https://api.spokenalpha.com/v1/calls/call_AAPL_2026Q2_earnings/analysis" \
  -H "Authorization: Bearer $SPOKEN_ALPHA_API_KEY"

Annotated sample response

200 OK — Starter tier (full shape)

{
  "call_id": "call_AAPL_2026Q2_earnings",

  // Available on all tiers — plain-English summary of language patterns
  "narrative": "Management language showed increased hedging around
    the guidance discussion relative to recent quarters. The CFO's
    prepared remarks were notably more qualified than the prior two calls.",

  // Starter+ only — null on Free
  "risk_index": 6.8,          // 0–10 composite language-risk score
  "risk_bin": "medium",        // "low" | "medium" | "high"
  "cohort_percentile": 0.72,   // percentile vs. historical sector cohort

  // Starter+ only — key guidance language that influenced the analysis
  "relevant_guidance": "We expect revenue in the range of $X to $Y,
    subject to macroeconomic conditions.",

  // Starter+ only — model output, NOT a trading recommendation
  "calibrated_p_miss_90d": 0.61,

  "methodology_version": "v1.0",  // pin this for reproducible pipelines
  "wall_safe": true               // false on Free tier (narrative only)
}

calibrated_p_miss_90d is a model output derived from language patterns. Spoken Alpha is a software product, not an investment adviser — treat model outputs as one input among many, not as trading signals in isolation.

Next steps

Explore all endpoints in the full API reference.
Understand rate limits in the auth & rate limits section.
Unlock more fields by upgrading to Starter ($99/mo) — removes the null on risk_index, risk_bin, and cohort_percentile.
Questions? hello@spokenalpha.com

# Step 1: list recent AAPL calls to find the current call_id export SPOKEN_ALPHA_API_KEY="YOUR_API_KEY" curl "https://api.spokenalpha.com/v1/companies/AAPL/earnings-calls?limit=1" \ -H "Authorization: Bearer $SPOKEN_ALPHA_API_KEY"

Annotated sample response

200 OK — Starter tier (full shape)

{
  "call_id": "call_AAPL_2026Q2_earnings",

  // Available on all tiers — plain-English summary of language patterns
  "narrative": "Management language showed increased hedging around
    the guidance discussion relative to recent quarters. The CFO's
    prepared remarks were notably more qualified than the prior two calls.",

  // Starter+ only — null on Free
  "risk_index": 6.8,          // 0–10 composite language-risk score
  "risk_bin": "medium",        // "low" | "medium" | "high"
  "cohort_percentile": 0.72,   // percentile vs. historical sector cohort

  // Starter+ only — key guidance language that influenced the analysis
  "relevant_guidance": "We expect revenue in the range of $X to $Y,
    subject to macroeconomic conditions.",

  // Starter+ only — model output, NOT a trading recommendation
  "calibrated_p_miss_90d": 0.61,

  "methodology_version": "v1.0",  // pin this for reproducible pipelines
  "wall_safe": true               // false on Free tier (narrative only)
}