Every API here is available over the APIs.io API and to AI agents over MCP.
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