roic-ai Bulk Downloads API
Pre-generated CSV datasets delivered through short-lived signed URLs.
Pre-generated CSV datasets delivered through short-lived signed URLs.
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/roic-ai:roic-ai-bulk-downloads-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. 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: ROIC Bulk Downloads API
description: The ROIC API reference for v3 (`/v3.0.0`) and legacy v2 (`/v2`). In v3, Bearer authentication is recommended because it keeps credentials out of URLs. For browser testing, you may instead pass your key as the `apikey` query parameter. Use exactly one authentication method per request, never both. v2 takes the key only as the `apikey` query parameter.
version: 3.0.0
servers:
- url: https://api.roic.ai
tags:
- name: Bulk Downloads
description: Pre-generated CSV datasets delivered through short-lived signed URLs.
paths:
/v3.0.0/fundamental/bulk:
get:
operationId: listBulkFundamentals
summary: List bulk fundamentals files
description: Lists pre-generated CSV files partitioned by fiscal year and financial cadence, each with a short-lived signed download URL. Filter with the optional year and period parameters. Requires a Professional or Enterprise plan.
tags:
- Bulk Downloads
security:
- bearerAuth: []
- apiKeyAuth: []
parameters:
- name: apikey
in: query
required: false
schema:
description: Browser-friendly alternative to Bearer authentication. Use either this parameter or the Authorization header, never both.
type: string
- name: year
in: query
required: false
schema:
minimum: 1900
maximum: 2100
multipleOf: 1
title: year
description: Return only the files of this year. Fiscal year for fundamentals and earnings calls, calendar year for stock prices.
anyOf:
- format: numeric
default: 0
type: string
- minimum: 1900
maximum: 2100
multipleOf: 1
title: year
description: Return only the files of this year. Fiscal year for fundamentals and earnings calls, calendar year for stock prices.
type: number
- name: period
in: query
required: false
schema:
type: string
enum:
- annual
- quarterly
- ttm
responses:
'200':
description: Response for status 200
content:
application/json:
schema:
$ref: '#/components/schemas/v3.BulkFileList'
'400':
description: Response for status 400
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'401':
description: Response for status 401
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'402':
description: Response for status 402
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'429':
description: Response for status 429
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'500':
description: Response for status 500
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'503':
description: Response for status 503
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
x-fern-sdk-group-name: fundamentals.bulk
x-fern-sdk-method-name: list
/v3.0.0/earnings-calls/bulk:
get:
operationId: listBulkEarningsCalls
summary: List bulk earnings-call files
description: Lists pre-generated transcript CSV files partitioned by fiscal year and quarter, each with a short-lived signed download URL. Filter with the optional year and period parameters. Requires a Professional or Enterprise plan.
tags:
- Bulk Downloads
security:
- bearerAuth: []
- apiKeyAuth: []
parameters:
- name: apikey
in: query
required: false
schema:
description: Browser-friendly alternative to Bearer authentication. Use either this parameter or the Authorization header, never both.
type: string
- name: year
in: query
required: false
schema:
minimum: 1900
maximum: 2100
multipleOf: 1
title: year
description: Return only the files of this year. Fiscal year for fundamentals and earnings calls, calendar year for stock prices.
anyOf:
- format: numeric
default: 0
type: string
- minimum: 1900
maximum: 2100
multipleOf: 1
title: year
description: Return only the files of this year. Fiscal year for fundamentals and earnings calls, calendar year for stock prices.
type: number
- name: period
in: query
required: false
schema:
type: string
enum:
- q1
- q2
- q3
- q4
responses:
'200':
description: Response for status 200
content:
application/json:
schema:
$ref: '#/components/schemas/v3.BulkFileList'
'400':
description: Response for status 400
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'401':
description: Response for status 401
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'402':
description: Response for status 402
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'429':
description: Response for status 429
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'500':
description: Response for status 500
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'503':
description: Response for status 503
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
x-fern-sdk-group-name: earningsCalls.bulk
x-fern-sdk-method-name: list
/v3.0.0/stock-prices/bulk:
get:
operationId: listBulkStockPrices
summary: List bulk stock-price files
description: Lists pre-generated daily-price CSV files partitioned by calendar year and month, each with a short-lived signed download URL. Filter with the optional year and period parameters. Requires a Professional or Enterprise plan.
tags:
- Bulk Downloads
security:
- bearerAuth: []
- apiKeyAuth: []
parameters:
- name: apikey
in: query
required: false
schema:
description: Browser-friendly alternative to Bearer authentication. Use either this parameter or the Authorization header, never both.
type: string
- name: year
in: query
required: false
schema:
minimum: 1900
maximum: 2100
multipleOf: 1
title: year
description: Return only the files of this year. Fiscal year for fundamentals and earnings calls, calendar year for stock prices.
anyOf:
- format: numeric
default: 0
type: string
- minimum: 1900
maximum: 2100
multipleOf: 1
title: year
description: Return only the files of this year. Fiscal year for fundamentals and earnings calls, calendar year for stock prices.
type: number
- name: period
in: query
required: false
schema:
type: string
enum:
- '01'
- '02'
- '03'
- '04'
- '05'
- '06'
- '07'
- 08
- 09
- '10'
- '11'
- '12'
responses:
'200':
description: Response for status 200
content:
application/json:
schema:
$ref: '#/components/schemas/v3.BulkFileList'
'400':
description: Response for status 400
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'401':
description: Response for status 401
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'402':
description: Response for status 402
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'429':
description: Response for status 429
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'500':
description: Response for status 500
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
'503':
description: Response for status 503
content:
application/json:
schema:
$ref: '#/components/schemas/v3.Error'
x-fern-sdk-group-name: stockPrices.bulk
x-fern-sdk-method-name: list
components:
schemas:
v3.Error:
type: object
properties:
error:
type: object
properties:
type:
type: string
enum:
- invalid_request_error
- authentication_error
- payment_required_error
- conflict_error
- rate_limit_error
- api_error
code:
type: string
message:
type: string
param:
type: string
doc_url:
type: string
request_id:
type: string
required:
- type
- code
- message
- request_id
required:
- error
$id: '#/components/schemas/v3.Error'
v3.BulkFileList:
additionalProperties: false
type: object
properties:
data:
type: array
items:
additionalProperties: false
type: object
properties:
id:
type: string
dataset:
type: string
enum:
- fundamentals
- earnings-calls
- stock-prices
year:
minimum: 1900
maximum: 2100
anyOf:
- format: integer
default: 0
type: string
- minimum: 1900
maximum: 2100
type: integer
period:
description: 'Dataset-specific period: financial cadence, fiscal quarter, or two-digit calendar month.'
type: string
format:
const: csv
type: string
compression:
description: Files are gzip-compressed. Decompress before reading the CSV.
const: gzip
type: string
size:
minimum: 0
description: Size of the compressed file in bytes.
anyOf:
- format: integer
default: 0
type: string
- minimum: 0
description: Size of the compressed file in bytes.
type: integer
sha256:
pattern: ^[0-9a-f]{64}$
description: SHA-256 of the compressed file, for verifying a download.
type: string
updated_at:
format: date-time
type: string
url:
format: uri
description: Signed download link. Send a plain GET request without the API key.
type: string
expires_at:
format: date-time
description: Time after which the signed link stops working.
type: string
required:
- id
- dataset
- year
- period
- format
- compression
- size
- sha256
- updated_at
- url
- expires_at
$id: '#/components/schemas/v3.BulkFile'
next_page_url:
anyOf:
- type: string
- type: 'null'
previous_page_url:
anyOf:
- type: string
- type: 'null'
required:
- data
- next_page_url
- previous_page_url
$id: '#/components/schemas/v3.BulkFileList'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Recommended. Send your ROIC API key as a Bearer token.
apiKeyAuth:
type: apiKey
in: query
name: apikey
description: Browser-friendly alternative. Do not combine this query parameter with the Authorization header.