BeliefState

BeliefState Tickers API

The Tickers API from BeliefState — 1 operation(s) for tickers.

GitHub OpenAPI

Operations 1

GET /v1/tickers Find tickers with available research #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/beliefstate-ai/openapi/beliefstate-ai-tickers-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-tickers-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

beliefstate-ai-tickers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: BeliefState Intelligence Tickers 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: Tickers
paths:
  /v1/tickers:
    get:
      operationId: getTickers
      summary: Find tickers with available research
      description: Without q, returns released direct ticker coverage, belief and investor counts, and observation dates. With q, searches the current SEC registered US company directory by ticker or company name and labels direct research availability. Directory coverage is not global. Public discovery is free; omit as_of when searching. Set tracked_only=true with a customer Bearer credential to read the account's active watchlist; omit as_of in that mode.
      x-mint:
        href: /api-reference/tickers/find-tickers-with-available-research
        metadata:
          title: Ticker research coverage
          description: Find tickers with released BeliefState research, inspect coverage counts and observation dates, or search the current US company directory.
      tags:
      - Tickers
      security: []
      parameters:
      - in: query
        name: q
        required: false
        schema:
          description: Search the current SEC company directory by ticker or name, independently of direct research coverage. Omit as_of.
          type: string
          minLength: 1
          maxLength: 80
      - in: query
        name: as_of
        required: false
        schema:
          type: string
          format: date-time
          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
      - in: query
        name: tracked_only
        required: false
        schema:
          description: Return only your account's actively tracked tickers. Requires customer authentication; omit as_of.
          type: boolean
      responses:
        '200':
          description: Successful public discovery response
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  limitations:
                    type: array
                    items:
                      type: string
                      minLength: 1
                  coverage_scope:
                    type: string
                    enum:
                    - released_library
                    - query_matches
                  fund_discovery:
                    type: object
                    properties:
                      query:
                        type: string
                      scope:
                        type: string
                        const: fund_identity
                      results:
                        type: array
                        items:
                          type: object
                          properties:
                            ticker:
                              type: string
                            name:
                              type: string
                            source_url:
                              type: string
                              format: uri
                            research_tool:
                              type: string
                              const: get_brief
                          required:
                          - ticker
                          - name
                          - source_url
                          - research_tool
                          additionalProperties: false
                      limitation:
                        type: string
                    required:
                    - query
                    - scope
                    - results
                    - limitation
                    additionalProperties: false
                  discovery:
                    type: object
                    properties:
                      query:
                        type: string
                      scope:
                        type: string
                        const: sec_registered_us_listings
                      source_url:
                        type: string
                        format: uri
                      results:
                        type: array
                        items:
                          type: object
                          properties:
                            ticker:
                              type: string
                            name:
                              type: string
                            exchange:
                              type:
                              - string
                              - 'null'
                            cik:
                              type: number
                            direct_research:
                              type: boolean
                          required:
                          - ticker
                          - name
                          - exchange
                          - cik
                          - direct_research
                          additionalProperties: false
                    required:
                    - query
                    - scope
                    - source_url
                    - results
                    additionalProperties: false
                  tracking:
                    type: object
                    properties:
                      limit:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      active:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      paused:
                        type: array
                        items:
                          type: string
                      unavailable:
                        type: array
                        items:
                          type: string
                      related_or_pending:
                        type: array
                        items:
                          type: string
                      manage_url:
                        type: string
                    required:
                    - limit
                    - active
                    - paused
                    - unavailable
                    - manage_url
                    additionalProperties: false
                  schema_version:
                    type: string
                    const: '1'
                  generated_at:
                    type: string
                    format: date-time
                    pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                  as_of:
                    type: string
                    format: date-time
                    pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                  resource:
                    type: string
                    const: beliefs
                  tickers:
                    type: array
                    items:
                      type: string
                      minLength: 1
                  totals:
                    type: object
                    properties:
                      ticker_count:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      belief_count:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                    required:
                    - ticker_count
                    - belief_count
                    additionalProperties: false
                  coverage:
                    type: array
                    items:
                      type: object
                      properties:
                        ticker:
                          type: string
                          minLength: 1
                        security_id:
                          type: string
                          minLength: 1
                        security_name:
                          type: string
                          minLength: 1
                        release_state:
                          type: string
                          const: released
                        release_effective_at:
                          type: string
                          format: date-time
                          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                        belief_count:
                          type: integer
                          exclusiveMinimum: 0
                          maximum: 9007199254740991
                        investor_count:
                          type: integer
                          exclusiveMinimum: 0
                          maximum: 9007199254740991
                        first_belief_observed_at:
                          type: string
                          format: date-time
                          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                        latest_belief_observed_at:
                          type: string
                          format: date-time
                          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
                      required:
                      - ticker
                      - security_id
                      - security_name
                      - release_state
                      - release_effective_at
                      - belief_count
                      - investor_count
                      - first_belief_observed_at
                      - latest_belief_observed_at
                      additionalProperties: false
                required:
                - schema_version
                - generated_at
                - as_of
                - resource
                - tickers
                - totals
                - coverage
                additionalProperties: false
        '400':
          description: Invalid input
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      recovery:
                        type:
                        - string
                        - 'null'
                      retryable:
                        type: boolean
                    required:
                    - code
                    - message
                    - recovery
                    - retryable
                    additionalProperties: false
                required:
                - error
                additionalProperties: false
        '503':
          description: Stored intelligence temporarily unavailable
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      recovery:
                        type:
                        - string
                        - 'null'
                      retryable:
                        type: boolean
                    required:
                    - code
                    - message
                    - recovery
                    - retryable
                    additionalProperties: false
                required:
                - error
                additionalProperties: false
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