Skip to main content

Data API preview

Preview of Alphio Agent API v1 — read-only data endpoints with stable schemas.

Find it at: not yet publicly available. The endpoints below describe the v1 surface scheduled for early-access release.

warning

v1 endpoints below are preview only — exact URLs and field shapes may change before public launch. Treat them as a shape guide rather than a contract.

1. Search endpoints​

The search surface returns popular and trending symbols across stocks and crypto, plus curated feature lists.

  • GET /v1/search/default — default discovery payload: popular stocks, popular crypto, feature blocks, and trending news. Used by clients on first load when the user hasn't typed anything yet.
  • GET /v1/search/symbol?q=<query> — symbol-name search across the supported universe (US / HK stocks, ETFs, crypto, FX, metals).

Search endpoints are read-only and safe to call without authentication during preview, but rate limits still apply per key / wallet.

2. Market news​

  • GET /v1/news/market-news — paginated market-wide news stream with timestamps and source attribution.
  • GET /v1/news/symbol-news?symbol=<ticker> — news filtered to a single ticker.

News items include an Alphio AI summary field where available, so clients don't have to re-summarise upstream content.

3. AI top picks​

  • GET /v1/finance/daily-top-pick/stocks — daily stock top-pick list curated by Alphio AI.
  • GET /v1/finance/daily-top-pick/crypto — daily crypto top-pick list.

Each entry includes the symbol, conviction level, and a short rationale string.

4. Symbol fundamentals​

Fundamentals split into three logical surfaces:

  • Snapshot — GET /v1/finance/symbol/:symbol/snapshot — price summary, key ratios, headline metrics.
  • Valuation — GET /v1/finance/symbol/:symbol/valuation — multiples, peer comparison, valuation signals.
  • Financials — GET /v1/finance/symbol/:symbol/financials — income statement, balance sheet, cash flow.

Snapshot is updated intraday; valuation and financials follow filing cadence.

5. Earnings & predictions​

  • GET /v1/finance/earnings/calendar — upcoming earnings with date, time-of-day, consensus.
  • GET /v1/finance/earnings/predictions?symbol=<ticker> — Alphio AI pre-earnings predictions (estimate vs. consensus deltas, scenario calls).
  • GET /v1/finance/earnings/transcripts?symbol=<ticker> — earnings call transcripts with speaker tagging where available.

Past earnings have an associated post-call analysis where Alphio AI has run one.

6. Calendars & events​

  • GET /v1/finance/calendar/economic — macro / economic releases.
  • GET /v1/finance/calendar/ipo — upcoming IPOs.
  • GET /v1/finance/calendar/crypto — major crypto events (unlocks, mainnet launches).
  • GET /v1/finance/calendar/webcast — investor day / webcast schedule.

All calendar endpoints support a date-range filter and a region / market filter where applicable.

7. Market indicators​

  • GET /v1/finance/indicators/fear-greed — fear & greed index time series.
  • GET /v1/finance/indicators/sentiment — broader sentiment aggregates (news, social).
  • GET /v1/finance/indicators/digest — daily / weekly digest content (the source data behind Market Brief).

Indicator endpoints return both the current value and recent history for charting.

8. Whales tracking​

  • GET /v1/finance/whales/institutional?symbol=<ticker> — 13F institutional positions and recent changes.
  • GET /v1/finance/whales/congress?symbol=<ticker> — US congressional trade disclosures.

Where Alphio surfaces wallet-level tracking (for crypto), an additional /wallets endpoint will be added in a later preview.

9. Example request​

A minimal request uses the API Key Bearer header documented in Authentication:

curl https://api.alphio.example/v1/finance/daily-top-pick/stocks \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Accept: application/json"

The same call via x402 (pay-as-you-go) replaces the Bearer header with x402 payment headers — your x402 client library handles the header construction; see Authentication for the protocol overview.

warning

The host api.alphio.example is a placeholder. The actual API host and exact path prefixes will be published with the early-access invite — do not hard-code the example host into production clients.

Agent Instructions: Querying This Documentation

If you need information not on this page, you can query the docs dynamically by sending a GET request with the ask query parameter:

GET https://docs.alphio.ai/trade/agent-api/data-api-preview.md?ask=<question>

The question should be specific, self-contained, and written in natural language. The response includes a direct answer plus relevant excerpts and sources.