# BeliefState Research API

**Canonical:** https://apis.io/apis/beliefstate-ai/beliefstate-ai-research-api/  
**Provider:** BeliefState — https://apis.io/providers/beliefstate-ai/  
**Base URL:** https://beliefstate.ai  
**Documentation:** https://docs.beliefstate.ai/api-reference/beliefs/find-investor-beliefs-or-inspect-a-full-record

BeliefState Research API is one of 7 APIs that [BeliefState](https://apis.io/providers/beliefstate-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Research. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

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

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/beliefstate-ai/openapi/beliefstate-ai-research-api-openapi.yml
- **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

## Other BeliefState APIs (6)

- [BeliefState Access API](https://apis.io/apis/beliefstate-ai/beliefstate-ai-access-api/)
- [BeliefState Beliefs API](https://apis.io/apis/beliefstate-ai/beliefstate-ai-beliefs-api/)
- [BeliefState Brief API](https://apis.io/apis/beliefstate-ai/beliefstate-ai-brief-api/)
- [BeliefState Research payments API](https://apis.io/apis/beliefstate-ai/beliefstate-ai-research-payments-api/)
- [BeliefState Sources API](https://apis.io/apis/beliefstate-ai/beliefstate-ai-sources-api/)
- [BeliefState Tickers API](https://apis.io/apis/beliefstate-ai/beliefstate-ai-tickers-api/)

## Tags

Research

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/beliefstate-ai/beliefstate-ai-research-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/beliefstate-ai/.