OQRO Compare API

The Compare API from OQRO — 1 operation(s) for compare.

GitHub OpenAPI

Operations 1

GET /api/v1/compare Two covered companies side by side: the same facts as the company endpoint for… #

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-compare-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-compare-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OQRO Compare 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: Compare
paths:
  /api/v1/compare:
    get:
      operationId: compare
      summary: 'Two covered companies side by side: the same facts as the company endpoint for…'
      description: 'Two covered companies side by side: the same facts as the company endpoint for each, with the OQRO comparison page when one exists.'
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: a
        in: query
        required: true
        description: First ticker, for example NVDA.
        schema:
          type: string
      - name: b
        in: query
        required: true
        description: Second ticker, for example AMD.
        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:
      - Compare
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