OQRO Screen API

The Screen API from OQRO — 1 operation(s) for screen.

GitHub OpenAPI

Operations 1

GET /api/v1/screen Filter and sort every covered company that has price and financial figures on… #

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-screen-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-screen-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OQRO Screen 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: Screen
paths:
  /api/v1/screen:
    get:
      operationId: screen
      summary: Filter and sort every covered company that has price and financial figures on…
      description: Filter and sort every covered company that has price and financial figures on published numbers. All filters combine with AND; a company with no figure for a filtered number is left out, never counted as zero.
      security:
      - bearer: []
      - apiKey: []
      parameters:
      - name: sector
        in: query
        required: false
        description: GICS sector, for example Health Care or Energy.
        schema:
          type: string
      - name: min_market_value
        in: query
        required: false
        description: Market value in US dollars (latest close times shares outstanding).
        schema:
          type: number
      - name: max_market_value
        in: query
        required: false
        description: Market value in US dollars (latest close times shares outstanding).
        schema:
          type: number
      - name: min_change_12m
        in: query
        required: false
        description: Price change over 12 months, in percent (negative allowed).
        schema:
          type: number
      - name: max_change_12m
        in: query
        required: false
        description: Price change over 12 months, in percent (negative allowed).
        schema:
          type: number
      - name: min_vs_sp500_12m
        in: query
        required: false
        description: Percentage points ahead of (+) or behind (-) the S&P 500 over 12 months.
        schema:
          type: number
      - name: max_vs_sp500_12m
        in: query
        required: false
        description: Percentage points ahead of (+) or behind (-) the S&P 500 over 12 months.
        schema:
          type: number
      - name: within_pct_of_12m_high
        in: query
        required: false
        description: At most this many percent below the 12-month high.
        schema:
          type: number
      - name: at_least_pct_below_12m_high
        in: query
        required: false
        description: At least this many percent below the 12-month high.
        schema:
          type: number
      - name: min_insider_purchases_90d
        in: query
        required: false
        description: At least this many open-market insider purchases of $10K or more in the last 90 days.
        schema:
          type: integer
      - name: min_congress_purchases_90d
        in: query
        required: false
        description: At least this many Congress purchases disclosed in the last 90 days.
        schema:
          type: integer
      - name: min_fund_adds_180d
        in: query
        required: false
        description: At least this many 13F new or increased positions disclosed in the last 180 days.
        schema:
          type: integer
      - name: has_federal_contracts_90d
        in: query
        required: false
        description: 'true: at least one federal contract award in the last 90 days.'
        schema:
          type: boolean
      - name: profitable
        in: query
        required: false
        description: 'true: positive net income in the last fiscal year.'
        schema:
          type: boolean
      - name: positive_free_cash_flow
        in: query
        required: false
        description: 'true: operating cash flow minus capital expenditure above zero in the last fiscal year (not returned for banks and insurers).'
        schema:
          type: boolean
      - name: net_cash
        in: query
        required: false
        description: 'true: more cash than debt at the latest report (not for banks and insurers).'
        schema:
          type: boolean
      - name: min_days_to_cover
        in: query
        required: false
        description: Minimum FINRA short-interest days to cover.
        schema:
          type: number
      - name: sort_by
        in: query
        required: false
        description: One of market_value, change_12m, vs_sp500_12m, change_90d, vs_12m_high, insider_purchase_value_90d, insider_purchases_90d, congress_purchases_90d, fund_adds_180d, revenue, net_margin, free_cash_flow, days_to_cover, ticker. Default market_value.
        schema:
          type: string
      - name: direction
        in: query
        required: false
        description: desc (default) or asc.
        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:
      - Screen
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