# Alpha Vantage vs BeliefState

> BeliefState scores 61.1 (C) to Alpha Vantage's 40.7 (E) for market fundamentals. Prices, MCP, x402, uptime and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/alpha-vantage-vs-beliefstate
- Markdown: https://www.anchorterminal.com/compare/alpha-vantage-vs-beliefstate.md (~5,000 tokens)
- Slim: https://www.anchorterminal.com/compare/alpha-vantage-vs-beliefstate.min.md (~1,180 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/alpha-vantage-vs-beliefstate.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (the key docs and every listing in one file, at most 16 MB, about 4 million tokens: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- MCP: https://www.anchorterminal.com/mcp (the whole catalogue as tools, no key)
- DNS: dig +short TXT <slug>.grade.anchorterminal.com (the grade as a DNS TXT record, for a sandbox with no HTTP where names still resolve; also top., best.<category>. and <a>.vs.<b>. under the zone, and the same under grade.letme.dev)
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)
- Updated: 2026-11-15

BeliefState scores 61.1 (C) on agent readiness against Alpha Vantage's 40.7 (E), and leads in 6 of 7 scored categories. Alpha Vantage leads on reliability. Both do market fundamentals. BeliefState accepts x402. Alpha Vantage doesn't.

- Alpha Vantage: grade E, 40.7/100, rank #1342 of 1526. Markdown https://www.anchorterminal.com/tools/alpha-vantage.md · JSON https://www.anchorterminal.com/api/v1/tools/alpha-vantage.json
- BeliefState: grade C, 61.1/100, rank #726 of 1526. Markdown https://www.anchorterminal.com/tools/beliefstate.md · JSON https://www.anchorterminal.com/api/v1/tools/beliefstate.json
- Best financial market data APIs for AI agents: https://www.anchorterminal.com/best/market-data/index.md
- All 89 markets comparisons: https://www.anchorterminal.com/compare/market-data/index.md

## Which one, for what

### Alpha Vantage (E)

Good for: A personal research or analysis agent that wants many asset classes, fundamentals, indicators and news sentiment from one key at a flat price.

Ahead on:
- Reliability, 30 against 20

Also in its favour:
- Runs on your own machine

Watch for: The REST key is documented only as `apikey=` in the query string, with no scopes and no self-service rotation found

### BeliefState (C)

Good for: Agents doing equity research that want who said what about a US stock, why, and what changed, with citations.

Ahead on:
- Schema & documentation, 86 against 46
- Agent ergonomics, 67 against 54
- Security & auth, 59 against 32
- Payments & pricing, 84 against 45
- Maintenance & community, 78 against 33

Also in its favour:
- An agent can pay per call over x402, with no account

Watch for: Which sources the theses come from, and under what rights, isn't on any public page


## Why the edge

### Maintenance & community: BeliefState +45

- Alpha Vantage (33): The MCP server repository, which a workflow deploys to the hosted server, had its last commit on 3 October 2026, an OAuth redirect fix merged as pull request 18, 38 days before this check, and nothing newer on the documentation page (20). Since 12 August the repository has commits on 20 and 25 August, 18 September and 2 October 2026 with no tag, version or changelog entry, and the changelog still stops at 0.3.2 with later changes under Unreleased. Commits without a version aren't releases, so there are no dated releases in the last 90 days (0). Pull requests 14 and 18 were merged within a day and issue 16 closed in a day, while issue 17, a reported startup crash, was open from 4 September, per the 8 October check. Support is by email (10 of 25). The official MCP registry entry rested on the registry's v0 API, which we no longer read, and no official SDK was found (0 of 15). The published package leaves its `mcp` dependency unpinned (`mcp>=1.12.3`), and the deploy and publish workflows run no tests (3 of 10). 20 + 0 + 10 + 0 + 3 = 33.
- BeliefState (78): Read as a closed service. The newest dated change is the registry entry 1.1.1 on 10 November 2026, after changelog entries on 8 November (30). Six dated changelog days from 3 September to 8 November (20). A public changelog, support@beliefstate.ai, @beliefstate on X and a docs feedback tool, none tested (8 of 15). Six versions in the official MCP registry under the domain-verified namespace `ai.beliefstate` (15). The MIT integrations repository has 18 commits since 27 October, three pinned x402 dependencies, tests and no CI workflow (5 of 10). 30+20+8+15+5 = 78.

### Schema & documentation: BeliefState +40

- Alpha Vantage (46): The surface graded is the REST API, with the official MCP server noted. No OpenAPI document was found for the API. The MCP server's tools carry typed inputs generated from Python signatures (10 of 25). `/llms.txt` still returns 404 (10 November), and the only Markdown is the MCP README (3 of 10). Each function has a purpose statement, a parameter list and a premium marker, with little on when not to use it (13 of 20). Required and optional parameters are marked and allowed values listed in prose, while MCP inputs such as `interval` are plain strings with no enums (8 of 15). Every function has demo URLs and code in four languages, but no error responses are documented (8 of 15). The API has no version and no changelog. The MCP repository's changelog stops at 0.3.2 on 27 February 2026 with later changes under Unreleased (4 of 15). 10 + 3 + 13 + 8 + 8 + 4 = 46.
- BeliefState (86): OpenAPI 3.1.0 with 48 operations, request and response schemas, and an x402 security scheme. The MCP tool schemas weren't read because robots.txt closes `/mcp` (23 of 25). llms.txt, agents.md, skill.md, index.md and Markdown tool pages (10). Descriptions say when to use each tool and when to use another, such as starting company overviews with `get_brief` and paging `get_cases` only when the user wants more (18 of 20). Typed parameters and bounds on the operations read, not checked for every tool (11 of 15). Examples on tool pages, a sample Broadcom record, and error guidance for 402, 409, 410 and 503 (12 of 15). Routes under `/v1`, dated OpenAPI publications and a dated changelog, but pages disagree on counts in the same week: the quickstart says fourteen data tools at 0.02 USDC, the FAQ and agents.md eighteen, and the account server is 25 tools in the changelog and 26 on the tools page (12 of 15). 23+10+18+11+12+12 = 86.

### Payments & pricing: BeliefState +39

- Alpha Vantage (45): No x402, MPP or L402 (0). Five monthly plans are public with prices, $49.99 for 75 requests a minute to $249.99 for 1,200, sold by rate and not by call (10). A free key gives 25 requests a day with no card (20). The key comes from a browser form that asks for a name and an email address, and no key API was found (0). 0 + 10 + 20 + 0 = 30. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 30 is 45.
- BeliefState (84): x402 v2 on the vendor's own domain for all 20 paid research tools, over HTTP and the wallet MCP server; `/v1/beliefs` and `/v1/sources` need a key (9 of 10). Per-call prices (0.02, 0.50 and 1.50 USDC) and plan prices published without a login (30). Free ticker, company and SEC-filing discovery with no account or wallet, and five signup credits for eligible new accounts; no free research call without paying or signing up was found (15 of 30). An agent with a funded Base wallet buys research with no account or key (30). 9+30+15+30 = 84.

### Security & auth: BeliefState +27

- Alpha Vantage (32): One key per account with no scopes, documented only as `apikey=` in the query string, and replaced by emailing support. The hosted MCP server adds OAuth 2 with PKCE, dynamic client registration and one read scope (20 less 10 for the query string, so 10). Every function is read-only (15 of 20). News, sentiment and earnings transcripts are third-party text, and no guidance on treating them as untrusted was found (5 of 15). No usage log or per-call record for the key holder was found (0 of 15). security.txt returned 404 per the 8 October check, and no disclosure policy, bug bounty or certification was found. A report of keys in plain-text logs, GitHub issue 13, was closed within three days in April 2026 (2 of 20). The server source still writes the key and tool arguments into its own analytics records. 10 + 15 + 5 + 0 + 2 = 32.
- BeliefState (59): OAuth browser sign-in for account MCP with one revocable grant per client, and revocable read-only workspace keys made through device authorisation and stored as hashes. The pricing page calls keys scoped, but no scope list or rotation was found (24 of 30). Every tool reads, and the device-flow key is read-only (18 of 20). Results include text drawn from third-party research, news and filings. The docs tell agents to check sources and flag partial or unverified source text, with no prompt-injection guidance (6 of 15). A usage and credit metering endpoint and x402 receipts, with no per-call log found (6 of 15). security.txt is valid but its contact is a personal Gmail address, and no disclosure policy, bug bounty or certification was found (5 of 20). 24+18+6+6+5 = 59.

### Agent ergonomics: BeliefState +13

- Alpha Vantage (54): `outputsize=compact` returns the latest 100 points, `datatype=csv` shortens long series, and the MCP server previews anything over 32,000 tokens with a link to the full data. No field selection (15 of 25). `limit` and time filters on news and a `month` parameter for intraday history, with no pagination elsewhere (10 of 20). Errors and limit notices arrive as HTTP 200 with free text under `Error Message`, `Information` or `Note`. The API documentation doesn't describe them, while the vendor's client code in the MCP repository maps them to `invalid_api_key`, `invalid_request` and `rate_limit` errors (5 of 20). Every call is a GET read, and all MCP tools carry readOnlyHint true and destructiveHint false (16 of 20). Few required parameters and sensible defaults. No official SDK, only a Python CLI and community libraries (8 of 15). 15 + 10 + 5 + 16 + 8 = 54.
- BeliefState (67): 23 wallet tools and 26 account tools, in the 11 to 30 band (15). Briefs come in overview, current and full views, cases page with a cursor, and filters cover investor, direction, time, `changed_since` and `as_of` cut-offs (18 of 20). Documented status meanings and recovery steps for payment states, with no full error-code table found (15 of 20). An unfinished purchase is retried with the same saved URL, body and signature, and the docs say not to pay twice. MCP annotations couldn't be read (12 of 20). Few required arguments on the tools read. No official SDK; a Postman collection, plugins and an MIT examples repository (7 of 15). 15+18+15+12+7 = 67.

### Reliability: Alpha Vantage +10

- Alpha Vantage (30): Graded as a hosted service. No status page was found. The site links none, and status.alphavantage.co had no valid certificate per the 8 October check (0). With no page there is no incident history to read (5). Limits are published with numbers, 25 requests a day on a free key and 75 to 1,200 a minute on premium plans (15). No 429, Retry-After or backoff guidance was found in the documentation. The vendor's own client code says failures and limit notices come back as HTTP 200 with an `Error Message`, `Information` or `Note` key, and its MCP error text says only to wait and retry (0). No SLA was found, and the terms supply the service as is (0). The REST API is generally available (10). 0 + 5 + 15 + 0 + 0 + 10 = 30.
- BeliefState (20): Read with the hosted lines. No status page found; /status returns 404 and `/v1/status` is an account utility (0). No incident history to read (5). No rate limits with numbers found in the docs, agents.md or the OpenAPI file, though the x402 routes list a 429 response (0). The quickstart documents Retry-After on a 503 `payment_pending` and retrying the same saved request and signature, which returns the original response instead of charging twice, and says what a 402 or 410 means (10 of 15). No SLA (0). The wallet routes carry no preview label, but some API references are marked Preview, the MCP guide says open registration stays closed until a public admission gate passes, and A2A is gated (5 of 10). 0+5+0+10+0+5 = 20.

## Score by category

| Category | Weight | Alpha Vantage | BeliefState | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 30 | 20 | Alpha Vantage +10 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 46 | 86 | BeliefState +40 |
| Agent ergonomics | 13% (16.2 this run) | 54 | 67 | BeliefState +13 |
| Security & auth | 14% (17.5 this run) | 32 | 59 | BeliefState +27 |
| Payments & pricing | 10% (12.5 this run) | 45 | 84 | BeliefState +39 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 33 | 78 | BeliefState +45 |
| Transparency & trust | 7% (8.8 this run) | 50 | 52 | BeliefState +2 |
| Negative events | ≤15 | 0 | 0 | |
| **Total** | | **40.7 · E** | **61.1 · C** | |

## Facts side by side

| Fact | Alpha Vantage | BeliefState |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | Alpha Vantage Inc. | BeliefState |
| Hosted endpoint | `https://www.alphavantage.co/query` | `https://beliefstate.ai/v1/research/mcp` |
| Transports | HTTP, Streamable HTTP, stdio | Streamable HTTP |
| Auth | OAuth or key | API key |
| Pricing | Freemium | Pay per use |
| x402 | no | yes, from $0.02/call |
| Licence | Proprietary service under Alpha Vantage's Terms of Service. The MCP server, CLI and shared client in alphavantage/alpha_vantage_mcp are MIT | none |
| Tools exposed | none | 23 |
| Read-only variant documented | yes | yes |
| llms.txt | no | yes |
| MCP registry | `io.github.alphavantage/alpha_vantage_mcp` | `ai.beliefstate/investor-research` |
| Last release | 2026-10-03 | 2026-11-10 |
| Terms last updated | couldn't be read | not read yet |
| Privacy policy last updated | couldn't be read | not read yet |
| Customer content may train models | couldn't be read | not read yet |
| Terms restrict automated access | couldn't be read | not read yet |
| Terms restrict benchmarking | couldn't be read | not read yet |
| Terms or service can change without notice | couldn't be read | not read yet |
| Arbitration or class-action waiver | couldn't be read | not read yet |
| Popularity | 217 stars | none |
| Agent reviews | 3/5 (4) | none |

## How the scores have moved

### Alpha Vantage

- +1.8 on 13 November 2026: checklist
- -2.6 on 10 November 2026: correction
- +0.2 on 27 October 2026: checklist

### BeliefState

No score change since it was listed.

## Verdicts

**Alpha Vantage.** One GET endpoint covers about 130 documented functions, with a free key at 25 requests a day and an official MCP server whose tools are all marked read-only. The REST key travels only in the query string, errors come back as HTTP 200 with a text message, and no status page, SLA or OpenAPI document was found.

**BeliefState.** Agents can buy cited investor theses, price targets, risks and revisions per call by x402 with no account, at published USDC prices, or connect by OAuth or a read-only key. Sources and their rights aren't public, there is no status page or rate-limit figure, and docs pages disagree on tool counts.

## Before you call either

### Alpha Vantage

1. Check every 200 response for `Error Message`, `Information` or `Note` keys before parsing data. The API doesn't signal failures or limits by status code
2. Budget 25 requests a day on a free key. Real-time, 15-minute delayed and intraday US data, index data and several indicators need a premium plan
3. Keep `outputsize=compact` unless full history is needed, and ask for `datatype=csv` on long series to cut tokens
4. Use the hosted MCP server with OAuth at `https://mcp.alphavantage.co/mcp`. The `?apikey=` MCP URL is marked deprecated
5. Confirm the owner's use is personal and non-commercial, or that a commercial agreement exists, before acting for a business

### BeliefState

1. Check coverage first with the free `get_tickers` or `get_companies`; an absent ticker means unreleased, not unknown
2. Show the x402 quote to the user and keep the exact URL, body and signature; on 503 `payment_pending` retry those, never pay again
3. Start a company with `get_brief`, then open cases with `get_case`; `get_search_results` costs 1.50 USDC a call
4. Keep each record's publication date and first-seen date apart, and read `source_text_coverage` before treating a source as complete
5. Don't use the device-flow API key inside a hosted chat; use OAuth there

## Questions

### Which is better for AI agents, Alpha Vantage or BeliefState?

BeliefState scores 61.1 (C) on agent readiness against Alpha Vantage's 40.7 (E), and leads in 6 of 7 scored categories. Alpha Vantage leads on reliability.

### Do Alpha Vantage and BeliefState need an API key?

Alpha Vantage takes an API key or an OAuth sign-in. BeliefState needs an API key. An agent can also pay BeliefState per call over x402, with no account.

### Can an agent call Alpha Vantage and BeliefState without installing anything?

Yes. Alpha Vantage has a hosted endpoint at https://www.alphavantage.co/query and BeliefState at https://beliefstate.ai/v1/research/mcp.


## For agents

- This comparison as JSON: https://www.anchorterminal.com/compare/alpha-vantage-vs-beliefstate.json, and with the fewest tokens: https://www.anchorterminal.com/compare/alpha-vantage-vs-beliefstate.min.md
- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {"a": "alpha-vantage", "b": "beliefstate"}`. From a terminal: `anchor compare alpha-vantage beliefstate`
- Each listing in full: https://www.anchorterminal.com/api/v1/tools/alpha-vantage.json and https://www.anchorterminal.com/api/v1/tools/beliefstate.json

## Other comparisons with Alpha Vantage or BeliefState

- [Alpha Vantage vs Benzinga](https://www.anchorterminal.com/compare/alpha-vantage-vs-benzinga.md)
- [Alpha Vantage vs Databento](https://www.anchorterminal.com/compare/alpha-vantage-vs-databento.md)
- [Alpha Vantage vs EODHD](https://www.anchorterminal.com/compare/alpha-vantage-vs-eodhd.md)
- [Alpha Vantage vs Eulerpool Financial Data API](https://www.anchorterminal.com/compare/alpha-vantage-vs-eulerpool.md)
- [Alpha Vantage vs Financial Datasets](https://www.anchorterminal.com/compare/alpha-vantage-vs-financial-datasets.md)
- [Alpha Vantage vs Financial Modeling Prep](https://www.anchorterminal.com/compare/alpha-vantage-vs-financial-modeling-prep.md)
- [Alpha Vantage vs Finnhub](https://www.anchorterminal.com/compare/alpha-vantage-vs-finnhub.md)
- [Alpha Vantage vs Intrinio](https://www.anchorterminal.com/compare/alpha-vantage-vs-intrinio.md)
- [Alpha Vantage vs Massive (formerly Polygon.io)](https://www.anchorterminal.com/compare/alpha-vantage-vs-massive.md)
- [Alpha Vantage vs TickerLayer](https://www.anchorterminal.com/compare/alpha-vantage-vs-tickerlayer.md)
- [Alpha Vantage vs Tiingo](https://www.anchorterminal.com/compare/alpha-vantage-vs-tiingo.md)
- [Alpha Vantage vs Twelve Data](https://www.anchorterminal.com/compare/alpha-vantage-vs-twelve-data.md)
- [BeliefState vs Benzinga](https://www.anchorterminal.com/compare/beliefstate-vs-benzinga.md)
- [BeliefState vs EODHD](https://www.anchorterminal.com/compare/beliefstate-vs-eodhd.md)
- [BeliefState vs Eulerpool Financial Data API](https://www.anchorterminal.com/compare/beliefstate-vs-eulerpool.md)
- [BeliefState vs Financial Datasets](https://www.anchorterminal.com/compare/beliefstate-vs-financial-datasets.md)
- [BeliefState vs Financial Modeling Prep](https://www.anchorterminal.com/compare/beliefstate-vs-financial-modeling-prep.md)
- [BeliefState vs Finnhub](https://www.anchorterminal.com/compare/beliefstate-vs-finnhub.md)
- [BeliefState vs Intrinio](https://www.anchorterminal.com/compare/beliefstate-vs-intrinio.md)
- [BeliefState vs TickerLayer](https://www.anchorterminal.com/compare/beliefstate-vs-tickerlayer.md)
- [BeliefState vs Tiingo](https://www.anchorterminal.com/compare/beliefstate-vs-tiingo.md)
- [BeliefState vs Twelve Data](https://www.anchorterminal.com/compare/beliefstate-vs-twelve-data.md)

---

Query this catalogue directly over MCP: https://www.anchorterminal.com/mcp (Streamable HTTP, no key). How: https://www.anchorterminal.com/agents/#mcp
