BeliefState

BeliefState Research API

The Research API from BeliefState — 18 operation(s) for research.

Documentation GitHub OpenAPI

Operations 18

GET /v1/research List paid research operations and exact prices #

POST /v1/research/mcp Call research tools with native MCP x402 payments #

GET /v1/research/get_belief_risks Read Read structured risks input/output schemas #

GET /v1/research/get_belief_catalysts Read Read structured catalysts input/output schemas #

GET /v1/research/get_author_track_record Read Read author track record input/output schemas #

GET /v1/research/search_beliefs Read Search investment ideas input/output schemas #

GET /v1/research/get_belief Read Read investment case input/output schemas #

GET /v1/research/compare_beliefs Read Compare investment ideas input/output schemas #

GET /v1/research/get_brief Read Research brief input/output schemas #

GET /v1/research/get_beliefs Read List investment ideas input/output schemas #

GET /v1/research/search_entities Read Find research subjects input/output schemas #

GET /v1/research/get_belief_changes Read Research changes input/output schemas #

GET /v1/research/get_context_assessment Read Read context assessment input/output schemas #

GET /v1/research/list_research_visuals Read List research visuals input/output schemas #

GET /v1/research/get_research_visual Read Read research visual input/output schemas #

GET /v1/research/get_belief_relationships Read Inspect case relationships input/output schemas #

GET /v1/research/evaluate_belief_scenario Read Test case assumptions input/output schemas #

GET /v1/research/refresh_market_data Read Refresh market context input/output schemas #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/beliefstate-ai/openapi/beliefstate-ai-research-api-openapi.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/beliefstate-ai/json-schema/beliefstate-ai-x402-get-brief-output-schema.json

📊

JSONSchema

https://artifacts.apis.io/beliefstate-ai/json-schema/beliefstate-ai-x402-list-research-visuals-output-schema.json

📊

JSONSchema

https://artifacts.apis.io/beliefstate-ai/json-schema/beliefstate-ai-x402-get-belief-output-schema.json

📊

JSONSchema

https://artifacts.apis.io/beliefstate-ai/json-schema/beliefstate-ai-x402-brief-overview-schema.json

📊

JSONSchema

https://artifacts.apis.io/beliefstate-ai/json-schema/beliefstate-ai-x402-get-beliefs-output-schema.json

📊

JSONSchema

https://artifacts.apis.io/beliefstate-ai/json-schema/beliefstate-ai-x402-get-context-assessment-output-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/beliefstate-ai:beliefstate-ai-research-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: BeliefState Intelligence Research API
  version: '2026-10-05'
  description: 'Four read only research resources: Brief for ticker research, Beliefs for records and evidence, Sources for the research directory, and Tickers for coverage. REST research uses API keys; AI clients use OAuth through /mcp. Accountless x402 research offers 16 tools through HTTP and native MCP. On this server, /v1/research is the free catalog with exact per-tool prices and schemas; /v1/research/mcp is wallet MCP. Data calls cost 0.02 USDC on Base; model comparison 0.50; model-assisted search 1.50. Read the exact quote before paying.'
servers:
- url: https://beliefstate.ai
tags:
- name: Research
paths:
  /v1/research:
    get:
      operationId: getX402ResearchCatalog
      summary: List paid research operations and exact prices
      security: []
      responses:
        '200':
          description: Free x402 operation catalog with public schema links
      tags:
      - Research
  /v1/research/mcp:
    post:
      operationId: callX402ResearchMcp
      summary: Call research tools with native MCP x402 payments
      description: Accountless MCP transport. tools/call returns PaymentRequired in both structuredContent and content text. A retry attaches the same signed payment at _meta[x402/payment]; success includes _meta[x402/payment-response] and a BeliefState receipt. Personal account tracking is available through authenticated /mcp.
      security: []
      responses:
        '200':
          description: MCP JSON-RPC tool result, payment requirements or settlement receipt
      tags:
      - Research
  /v1/research/get_belief_risks:
    get:
      operationId: getX402Contract_get_belief_risks
      summary: Read Read structured risks input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/get_belief_catalysts:
    get:
      operationId: getX402Contract_get_belief_catalysts
      summary: Read Read structured catalysts input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/get_author_track_record:
    get:
      operationId: getX402Contract_get_author_track_record
      summary: Read Read author track record input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/search_beliefs:
    get:
      operationId: getX402Contract_search_beliefs
      summary: Read Search investment ideas input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/get_belief:
    get:
      operationId: getX402Contract_get_belief
      summary: Read Read investment case input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/compare_beliefs:
    get:
      operationId: getX402Contract_compare_beliefs
      summary: Read Compare investment ideas input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/get_brief:
    get:
      operationId: getX402Contract_get_brief
      summary: Read Research brief input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/get_beliefs:
    get:
      operationId: getX402Contract_get_beliefs
      summary: Read List investment ideas input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/search_entities:
    get:
      operationId: getX402Contract_search_entities
      summary: Read Find research subjects input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/get_belief_changes:
    get:
      operationId: getX402Contract_get_belief_changes
      summary: Read Research changes input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/get_context_assessment:
    get:
      operationId: getX402Contract_get_context_assessment
      summary: Read Read context assessment input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/list_research_visuals:
    get:
      operationId: getX402Contract_list_research_visuals
      summary: Read List research visuals input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/get_research_visual:
    get:
      operationId: getX402Contract_get_research_visual
      summary: Read Read research visual input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/get_belief_relationships:
    get:
      operationId: getX402Contract_get_belief_relationships
      summary: Read Inspect case relationships input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/evaluate_belief_scenario:
    get:
      operationId: getX402Contract_evaluate_belief_scenario
      summary: Read Test case assumptions input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
  /v1/research/refresh_market_data:
    get:
      operationId: getX402Contract_refresh_market_data
      summary: Read Refresh market context input/output schemas
      security: []
      responses:
        '200':
          description: Free complete executable schemas, illustrative input and payment contract
      tags:
      - Research
components:
  securitySchemes:
    X402Payment:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: x402 v2 payment authorization obtained from the PAYMENT-REQUIRED quote; no API key or account required
    ApiKeyBearer:
      type: http
      scheme: bearer
      bearerFormat: BeliefState API key
      description: Developer API key created through /auth.md. Never paste it into a retail chat.
externalDocs:
  description: Connect an AI
  url: https://beliefstate.ai/agents