Head to head · Market fundamentals · October 2026 research run

BeliefState vs Tiingo

BeliefState scores 61.1 (C) on agent readiness against Tiingo's 48 (D), and leads in 5 of 7 scored categories. Tiingo leads on reliability and transparency & trust. Both do market fundamentals. BeliefState accepts x402. Tiingo doesn't.

Best financial market data APIs for AI agents · All 89 markets comparisons

Which one, for what

BeliefState C

Best 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 39
  • Agent ergonomics, 67 against 56
  • Security & auth, 59 against 32
  • Payments & pricing, 84 against 45
  • Maintenance & community, 78 against 50

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

Tiingo D

Best for Agents that need clean US end-of-day composites with dividend and split adjustments, fund fees and news on a cheap plan, and anyone who values a long changelog.

Ahead on

  • Reliability, 60 against 20
  • Transparency & trust, 57 against 52

Watch for

The connecting guide documents the token as ?token= in the URL alongside the header

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Schema & documentation BeliefState +47

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.

Tiingo 39

No OpenAPI document or MCP server was found (0 of 25). llms.txt and llms-full.txt are served, with product routing and licence notes (10). Each documentation page states the endpoint's purpose and timing, such as prices after 5.30 pm ET with corrections to 8 pm, with little on when not to use it (12 of 20). Parameters and response fields are tabled with names and meanings, but types, defaults and allowed values are partly in prose (8 of 15). Examples in Python, Node and PHP on every page; no error responses documented (7 of 15). A changelog dated by entry since 2017 and a one-year support commitment after breaking changes, with no version in the path (12 of 15). 0 + 10 + 12 + 8 + 7 + 12 = 39.

Reliability Tiingo +40

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.

Tiingo 60

Read with the hosted lines. A public status page on Instatus at status.tiingo.com lists 13 components with a notice history (20). The history in the 90 days to 3 November 2026 shows a 9 hour 59 minute outage of the Blue Ocean ATS endpoints on 21 October, a WebSocket issue on 21 September and two maintenance windows, with nothing recorded before 21 September; a long outage of one niche feed rather than the core price API (15). Limits are published with numbers, 50 and 10,000 requests an hour, 1,000 and 100,000 a day and 1 GB and 40 GB a month (15). No 429, Retry-After or backoff guidance was found (0). No SLA found (0). The end-of-day, news, crypto and forex APIs are generally available, while Equity Realtime and BOATS are in beta (10). 20 + 15 + 15 + 0 + 0 + 10 = 60.

Payments & pricing BeliefState +39

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.

Tiingo 45

No x402, MPP or L402 (0). Two plan prices public without login, $0 and $30 a month, sold by requests an hour and a day rather than per call; fundamentals and commercial licences by email (10). A free Starter plan at 1,000 requests a day with no card requirement stated (20). The token comes from a browser signup, and the developer programme forbids programmatic registration (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.

Maintenance & community BeliefState +28

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.

Tiingo 50

Read as a closed service. The changelog's newest entry is 9 October 2026 (30). Entries dated 9 October and 8 September 2026 fall in the last 90 days, with 21 July just outside, and the status page adds a maintenance window on 28 September (12 of 20). A dated changelog, a support address and a blog, with the developer programme promising priority email support (8 of 15). No official SDK (0 of 15). No package to assess (0 of 10). 30 + 12 + 8 + 0 + 0 = 50.

Security & auth BeliefState +27

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.

Tiingo 32

One token per account with no scopes, documented as ?token= in the URL or an Authorization header, with rotation on the account page since May 2026 (20 less 10 for the query string, plus 2 for rotation, so 12). Every endpoint is a read (15 of 20). News is third-party text and no guidance was found (5 of 15). A usage page shows hourly and daily requests and bandwidth, not a per-call log (0 of 15, no log). security.txt redirects on www and is absent on api, and no disclosure policy, bug bounty or certification was found (0 of 20). 12 + 15 + 5 + 0 + 0 = 32.

Agent ergonomics BeliefState +11

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.

Tiingo 56

startDate, endDate, resampleFreq, format=csv and column selection on some endpoints size responses; no field selection on end-of-day prices (15 of 25). Date ranges throughout and limit and offset on news, no cursor (15 of 20). Errors are undocumented; a missing token answered 403 with a JSON detail field in our one test call (3 of 20). Every call is a read (16 of 20). Few required parameters, but no official SDK; the docs point to third-party packages (7 of 15). 15 + 15 + 3 + 16 + 7 = 56.

Score by category

CategoryWeight this runBeliefStateTiingoEdge
Reliability16%202060Tiingo +40
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.28639BeliefState +47
Agent ergonomics13%16.26756BeliefState +11
Security & auth14%17.55932BeliefState +27
Payments & pricing10%12.58445BeliefState +39
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.87850BeliefState +28
Transparency & trust7%8.85257Tiingo +5
Negative events≤1500
TotalC 61.1/100D 48/100

Facts side by side

FactBeliefStateTiingo
KindHTTP APIHTTP API
VendorBeliefStateTiingo Inc.
Hosted endpointhttps://beliefstate.ai/v1/research/mcphttps://api.tiingo.com
TransportsStreamable HTTPHTTP, websocket
AuthAPI keyAPI key
PricingPay per useFreemium
x402yes, from $0.02/callno
Tools exposed23none
Read-only variant documentedyesno
llms.txtyesyes
MCP registryai.beliefstate/investor-researchnot listed
Last release2026-11-102026-10-09
Terms last updatednot read yetcouldn't be read
Privacy policy last updatednot read yet2026-02-18
Customer content may train modelsnot read yetcouldn't be read
Terms restrict automated accessnot read yetcouldn't be read
Terms restrict benchmarkingnot read yetcouldn't be read
Terms or service can change without noticenot read yetcouldn't be read
Arbitration or class-action waivernot read yetcouldn't be read

How the scores have moved

BeliefState

No score change since it was listed.

Tiingo

Verdicts

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.

Tiingo

A dated changelog since 2017, a one-year support commitment after breaking changes, an Instatus status page and a free token at 1,000 requests a day. The token is documented in the URL, no OpenAPI document, error reference, SDK or MCP server exists, and the terms and privacy policy sit on a host that refused our reader.

Before you call either

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

Tiingo

  1. Send the token as Authorization: Token <token>, not as ?token= in the URL
  2. Ask for format=csv on large price pulls; the docs say CSV is 4 to 5 times faster than JSON, and bandwidth counts against the monthly cap
  3. Count requests an hour and a day, not per second; 50 an hour on Starter, 10,000 on Power, reset on the hour and at midnight ET
  4. Expect 403 {"detail":"Please supply a token"} without a token; other error shapes are undocumented, so log the body
  5. Use dashes in share classes (BRK-A), and fetch supported_tickers.zip rather than guessing symbols

Questions

Which is better for AI agents, BeliefState or Tiingo?

BeliefState scores 61.1 (C) on agent readiness against Tiingo's 48 (D), and leads in 5 of 7 scored categories. Tiingo leads on reliability and transparency & trust.

Do BeliefState and Tiingo need an API key?

Both need an API key. An agent can also pay BeliefState per call over x402, with no account.

Can an agent call BeliefState and Tiingo without installing anything?

Yes. BeliefState has a hosted endpoint at https://beliefstate.ai/v1/research/mcp and Tiingo at https://api.tiingo.com.

Other comparisons with BeliefState or Tiingo

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.