OQRO Economy API

The Economy API from OQRO — 1 operation(s) for economy.

GitHub OpenAPI

Operations 1

GET /api/v1/economy The main US economic figures at their latest official release: Treasury yields… #

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-economy-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-economy-api-openapi.yml Raw ↑
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