OQRO Companies API

The Companies API from OQRO — 9 operation(s) for companies.

GitHub OpenAPI

Operations 9

GET /api/v1/companies/{ticker} One company: profile, latest close and 12-month change next to the S&P 500… #
GET /api/v1/companies/{ticker}/context What has been happening at one company, in one answer: its latest weekly note… #
GET /api/v1/companies/{ticker}/off-exchange Off-exchange trading of one company, week by week, from FINRA OTC Transparency… #
GET /api/v1/companies/{ticker}/fund-holders Mutual funds and ETFs holding one company, from SEC Form N-PORT: number of… #
GET /api/v1/companies/{ticker}/beneficial-owners Owners above 5% of one company from SEC Schedules 13D and 13G over about three… #
GET /api/v1/companies/{ticker}/risk-factors Risk factor headings of one company's latest annual report (Form 10-K or 20-F)… #
GET /api/v1/companies/{ticker}/sec-enforcement SEC litigation releases, administrative proceedings and trading suspensions… #
GET /api/v1/companies/{ticker}/insider-buy-context One company's recent insider open-market purchases (Form 4, code P), newest… #

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/oqro-io:oqro-io-companies-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

oqro-io-companies-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OQRO Companies API
  version: '1'
  x-api-versioning:
    scheme: URL path (/api/v1)
    policy: https://oqro.io/developers#versioning
  x-deprecation-policy:
    url: https://oqro.io/developers#versioning
    notice: A version is announced as deprecated at least 180 days before it is switched off. A deprecated version answers with Deprecation and Sunset headers (RFC 9745 and RFC 8594) and a Link header with rel="deprecation".
  description: Public disclosures (SEC Form 4 and 13F, Congress periodic reports, federal contracts, lobbying) as JSON, each row linked to its official source. Included with OQRO Pro; create a key in your account. Disclosures, not advice.
  termsOfService: https://oqro.io/terms
  contact:
    name: OQRO
    url: https://oqro.io/contact
    email: contact@oqro.io
servers:
- url: https://oqro.io
tags:
- name: Companies
paths:
  /api/v1/companies/search:
    get:
      operationId: companies_search
      summary: Find covered companies by ticker or part of a name
      description: Find covered companies by ticker or part of a name. Up to 20 matches, ticker matches first. Use it to resolve a name to a ticker.
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: q
        in: query
        required: true
        description: Ticker or part of a company name, up to 60 characters.
        schema:
          type: string
      responses:
        '200':
          description: 'JSON: { data, pagination?, meta? }. Every row links its official source.'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            API-Version:
              $ref: '#/components/headers/ApiVersion'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                  pagination:
                    type: object
                  meta:
                    type: object
                required:
                - data
        '400':
          $ref: '#/components/responses/InvalidParameter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/Unavailable'
      tags:
      - Companies
  /api/v1/companies/{ticker}:
    get:
      operationId: companies_ticker
      summary: 'One company: profile, latest close and 12-month change next to the S&P 500…'
      description: 'One company: profile, latest close and 12-month change next to the S&P 500, annual revenue and net income from SEC filings, latest FINRA short interest, and counts of recent disclosures.'
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: ticker
        in: path
        required: true
        description: A covered US ticker, for example AAPL.
        schema:
          type: string
      responses:
        '200':
          description: 'JSON: { data, pagination?, meta? }. Every row links its official source.'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            API-Version:
              $ref: '#/components/headers/ApiVersion'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                  pagination:
                    type: object
                  meta:
                    type: object
                required:
                - data
        '400':
          $ref: '#/components/responses/InvalidParameter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/Unavailable'
      tags:
      - Companies
  /api/v1/companies/{ticker}/context:
    get:
      operationId: companies_ticker_context
      summary: 'What has been happening at one company, in one answer: its latest weekly note…'
      description: 'What has been happening at one company, in one answer: its latest weekly note written from OQRO''s own facts, its recent Form 8-K reports (executive changes, results, auditor and listing notices, deals) with the company''s own opening sentence, mergers and acquisitions it is part of, and its 30 and 90 day price moves. Descriptive only: it never says why anyone traded.'
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: ticker
        in: path
        required: true
        description: A covered US ticker, for example AAPL.
        schema:
          type: string
      - name: days
        in: query
        required: false
        description: How far back the Form 8-K reports and deals go, 7 to 365 (default 120).
        schema:
          type: string
      responses:
        '200':
          description: 'JSON: { data, pagination?, meta? }. Every row links its official source.'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            API-Version:
              $ref: '#/components/headers/ApiVersion'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                  pagination:
                    type: object
                  meta:
                    type: object
                required:
                - data
        '400':
          $ref: '#/components/responses/InvalidParameter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/Unavailable'
      tags:
      - Companies
  /api/v1/companies/{ticker}/off-exchange:
    get:
      operationId: companies_ticker_off_exchange
      summary: Off-exchange trading of one company, week by week, from FINRA OTC Transparency…
      description: 'Off-exchange trading of one company, week by week, from FINRA OTC Transparency: shares traded on alternative trading systems (dark pools) and other off-exchange volume, their share of total volume, and the largest ATS venues. FINRA publishes each week 2 to 4 weeks after it ends.'
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: ticker
        in: path
        required: true
        description: A covered US ticker, for example AAPL.
        schema:
          type: string
      responses:
        '200':
          description: 'JSON: { data, pagination?, meta? }. Every row links its official source.'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            API-Version:
              $ref: '#/components/headers/ApiVersion'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                  pagination:
                    type: object
                  meta:
                    type: object
                required:
                - data
        '400':
          $ref: '#/components/responses/InvalidParameter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/Unavailable'
      tags:
      - Companies
  /api/v1/companies/{ticker}/fund-holders:
    get:
      operationId: companies_ticker_fund_holders
      summary: 'Mutual funds and ETFs holding one company, from SEC Form N-PORT: number of…'
      description: 'Mutual funds and ETFs holding one company, from SEC Form N-PORT: number of funds, total shares and value, how many funds opened, added to, trimmed or closed a position, and the 10 largest fund positions, each linked to its filing.'
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: ticker
        in: path
        required: true
        description: A covered US ticker, for example AAPL.
        schema:
          type: string
      responses:
        '200':
          description: 'JSON: { data, pagination?, meta? }. Every row links its official source.'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            API-Version:
              $ref: '#/components/headers/ApiVersion'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                  pagination:
                    type: object
                  meta:
                    type: object
                required:
                - data
        '400':
          $ref: '#/components/responses/InvalidParameter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/Unavailable'
      tags:
      - Companies
  /api/v1/companies/{ticker}/beneficial-owners:
    get:
      operationId: companies_ticker_beneficial_owners
      summary: Owners above 5% of one company from SEC Schedules 13D and 13G over about three…
      description: 'Owners above 5% of one company from SEC Schedules 13D and 13G over about three years: each owner''s latest percent and shares, 13D (may seek influence) or 13G (passive), the change against its previous filing, and the recent moves, each linked to its filing.'
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: ticker
        in: path
        required: true
        description: A covered US ticker, for example AAPL.
        schema:
          type: string
      responses:
        '200':
          description: 'JSON: { data, pagination?, meta? }. Every row links its official source.'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            API-Version:
              $ref: '#/components/headers/ApiVersion'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                  pagination:
                    type: object
                  meta:
                    type: object
                required:
                - data
        '400':
          $ref: '#/components/responses/InvalidParameter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/Unavailable'
      tags:
      - Companies
  /api/v1/companies/{ticker}/risk-factors:
    get:
      operationId: companies_ticker_risk_factors
      summary: Risk factor headings of one company's latest annual report (Form 10-K or 20-F)…
      description: 'Risk factor headings of one company''s latest annual report (Form 10-K or 20-F) compared with the year before: new headings, headings no longer listed, and the first lines of Legal proceedings. Differences are listed only when the comparison is reliable.'
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: ticker
        in: path
        required: true
        description: A covered US ticker, for example AAPL.
        schema:
          type: string
      responses:
        '200':
          description: 'JSON: { data, pagination?, meta? }. Every row links its official source.'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            API-Version:
              $ref: '#/components/headers/ApiVersion'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                  pagination:
                    type: object
                  meta:
                    type: object
                required:
                - data
        '400':
          $ref: '#/components/responses/InvalidParameter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/Unavailable'
      tags:
      - Companies
  /api/v1/companies/{ticker}/sec-enforcement:
    get:
      operationId: companies_ticker_sec_enforcement
      summary: SEC litigation releases, administrative proceedings and trading suspensions…
      description: 'SEC litigation releases, administrative proceedings and trading suspensions naming one company over about three years: date, release number, the SEC''s own first sentences, the settlement wording when there is one, and a link to sec.gov. Strict matching on the exact legal name or a stated CIK/ticker, so subsidiaries are not included.'
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: ticker
        in: path
        required: true
        description: A covered US ticker, for example AAPL.
        schema:
          type: string
      responses:
        '200':
          description: 'JSON: { data, pagination?, meta? }. Every row links its official source.'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            API-Version:
              $ref: '#/components/headers/ApiVersion'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                  pagination:
                    type: object
                  meta:
                    type: object
                required:
                - data
        '400':
          $ref: '#/components/responses/InvalidParameter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/Unavailable'
      tags:
      - Companies
  /api/v1/companies/{ticker}/insider-buy-context:
    get:
      operationId: companies_ticker_insider_buy_context
      summary: One company's recent insider open-market purchases (Form 4, code P), newest…
      description: 'One company''s recent insider open-market purchases (Form 4, code P), newest first, each with where the stock stood at the trade date: 52-week range, 30-day move, RSI(14), distance from the 50- and 200-day averages, drawdown, 20-day volatility and the move against SPY over 1, 3 and 6 months, plus a one-line reading. The company''s latest reported results are in meta.fundamentals. Past figures only, not a forecast.'
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: ticker
        in: path
        required: true
        description: A covered US ticker, for example AAPL.
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: Rows per page, 1 to 100. Default 25.
        schema:
          type: integer
      - name: cursor
        in: query
        required: false
        description: The pagination.next_cursor of the previous page, unchanged. Keep the same filters.
        schema:
          type: string
      responses:
        '200':
          description: 'JSON: { data, pagination?, meta? }. Every row links its official source.'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
            API-Version:
              $ref: '#/components/headers/ApiVersion'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: {}
                  pagination:
                    type: object
                  meta:
                    type: object
                required:
                - data
        '400':
          $ref: '#/components/responses/InvalidParameter'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
        '503':
          $ref: '#/components/responses/Unavailable'
      tags:
      - Companies
components:
  headers:
    RateLimitReset:
      description: Seconds until the minute window restarts.
      schema:
        type: integer
    RateLimitLimit:
      description: Requests allowed in the current minute window (IETF RateLimit field; X-RateLimit-Limit is the same number).
      schema:
        type: integer
    ApiVersion:
      description: The major version of the API that answered.
      schema:
        type: string
    RateLimitPolicy:
      description: The quotas of a key, each as limit;w=window-in-seconds, for example 60;w=60, 5000;w=86400.
      schema:
        type: string
    RetryAfter:
      description: Seconds to wait before trying again.
      schema:
        type: integer
    RateLimitRemaining:
      description: Requests left in the current minute window.
      schema:
        type: integer
  responses:
    InvalidParameter:
      description: '`invalid_parameter`: A query parameter is missing or out of range; "param" names it.'
      headers:
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimitPolicy'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: invalid_parameter
              message: A query parameter is missing or out of range; "param" names it.
    SubscriptionRequired:
      description: '`subscription_required`: Not used today: the API is free for every account and no paid plan is needed. Kept so older clients that handle this code keep working.'
      headers:
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimitPolicy'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: subscription_required
              message: 'Not used today: the API is free for every account and no paid plan is needed. Kept so older clients that handle this code keep working.'
    NotFound:
      description: '`ticker_not_covered`: The ticker is not a covered company; search /api/v1/companies/search. `not_found`: Nothing at that address.'
      headers:
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimitPolicy'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: ticker_not_covered
              message: The ticker is not a covered company; search /api/v1/companies/search.
    Unavailable:
      description: '`data_unavailable`: The data source did not answer; retry after Retry-After seconds. `service_unavailable`: The API could not check the key; retry in a moment.'
      headers:
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: data_unavailable
              message: The data source did not answer; retry after Retry-After seconds.
    RateLimited:
      description: '`rate_limited`: Over the quota: 60 requests a minute and 5,000 a day per key. Wait Retry-After seconds.'
      headers:
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: rate_limited
              message: 'Over the quota: 60 requests a minute and 5,000 a day per key. Wait Retry-After seconds.'
    ServerError:
      description: '`internal_error`: Something went wrong on OQRO''s side.'
      headers:
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimitPolicy'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: internal_error
              message: Something went wrong on OQRO's side.
    Unauthorized:
      description: '`missing_api_key`: No key was sent. Send "Authorization: Bearer <key>" or an X-API-Key header. `invalid_api_key`: The key is not valid or has been revoked.'
      headers:
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimitPolicy'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: missing_api_key
              message: 'No key was sent. Send "Authorization: Bearer <key>" or an X-API-Key header.'
  schemas:
    Error:
      type: object
      required:
      - error
      description: The one error shape of the API, for every 4xx and 5xx answer.
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              enum:
              - missing_api_key
              - invalid_api_key
              - subscription_required
              - rate_limited
              - invalid_parameter
              - ticker_not_covered
              - not_found
              - data_unavailable
              - service_unavailable
              - internal_error
              description: Machine-readable. Branch on this, not on the message.
            message:
              type: string
              description: A sentence for a person; it can change wording.
            param:
              type: string
              description: The query parameter at fault, for invalid_parameter.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
externalDocs:
  description: Documentation
  url: https://oqro.io/docs/api