OQRO Economy API
The Economy API from OQRO — 1 operation(s) for economy.
Operations 1
GET
/api/v1/economy
The main US economic figures at their latest official release: Treasury yields…
#
The Economy API from OQRO — 1 operation(s) for economy.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/oqro-io:oqro-io-economy-api"
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.
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: 3.2.0
info:
title: OQRO Economy 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: Economy
paths:
/api/v1/economy:
get:
operationId: economy
summary: 'The main US economic figures at their latest official release: Treasury yields…'
description: 'The main US economic figures at their latest official release: Treasury yields and the yield curve, the Fed target range and effective rate, CPI, unemployment and payrolls, CFTC futures positioning, and the releases and FOMC meetings of the next 45 days. Each figure carries its date and source.'
security:
- bearer: []
- apiKey: []
parameters: []
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:
- Economy
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