How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Databento Batch API

Submits asynchronous batch jobs that materialize large historical requests into downloadable flat files (DBN, CSV, or JSON), optionally split by day, symbol, or size. Submit a job, list your jobs and their state, and list the generated files with HTTPS and FTP download URIs. Files remain re-downloadable for 30 days at no extra cost.

Databento Batch API is one of 24 APIs that Databento publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Batch, Flat Files, Historical Market Data, Market Data, and Financial Data. The published artifact set on APIs.io includes API documentation, an API reference, and an OpenAPI specification.

This API exposes 17 operations across 16 paths, and defines 8 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against a single base URL, https://hist.databento.com/v0.

17 operations 16 paths 8 schemas 12 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://hist.databento.com/v0
Authentication
HTTP Basic, OAuth 2.0, HTTP Basic
Resource Areas
1

Authentication & Security 3

Databento Batch API declares 3 security schemes for authenticating requests. It accepts HTTP basic authentication (apiKeyBasicAuth). It supports OAuth 2.0 (OAuth2PasswordBearerWithCookie) using the password flow. It accepts HTTP basic authentication (HTTPBasic).

  • apiKeyBasicAuth — HTTP Basic authentication. Supply your Databento API key (prefixed with db-) as the username and leave the password empty.

Paths & Operations 17

Across 16 paths, the API surfaces 17 operations — 12 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Batch 17

Submit and manage asynchronous flat-file download jobs.

POST
/batch.submit_job
Submit batch job
batchSubmitJob body → 200401422
GET
/batch.list_jobs
List batch jobs
batchListJobs 2 params → 200401
GET
/batch.list_files
List batch files
batchListFiles 1 param → 200401404
POST
/v0/batch/me
Submit Batch Request With Token Auth
submit_batch_request_with_token_auth_v0_batch_me_post 21 params → 200206400401402403404422
GET
/v0/batch/me
List Batch Jobs With Auth Token
list_batch_jobs_with_auth_token_v0_batch_me_get 4 params → 200401403429422
POST
/v0/batch.submit_job
Submit Batch Request With Basic Auth
submit_batch_request_with_basic_auth_v0_batch_submit_job_post 2 params body → 200206400401402404422429
GET
/v0/batch.list_jobs
List Batch Jobs
list_batch_jobs_v0_batch_list_jobs_get 4 params → 200401404429422
GET
/v0/batch/progress/{job_id}
Get Job Progress By Id
get_job_progress_by_id_v0_batch_progress__job_id__get 2 params → 200401403404429422
GET
/v0/batch/files/{job_id}
Get Batch Files For Job
get_batch_files_for_job_v0_batch_files__job_id__get 5 params → 200401403429501422
GET
/v0/batch.list_files
List Batch Job Files With Basic Auth
list_batch_job_files_with_basic_auth_v0_batch_list_files_get 2 params → 200401404410429422
GET
/v0/batch/me/job_description/{job_id}
Get Job Description By Id
get_job_description_by_id_v0_batch_me_job_description__job_id__get 3 params → 200401403404429422
GET
/v0/batch/me/download/{job_id}/{filename}
Download Batch File With Token Auth
download_batch_file_with_token_auth_v0_batch_me_download__job_id___filename__get 2 params → 200401403404410429422
GET
/v0/batch.download
Download Batch Zip
download_batch_zip_v0_batch_download_get 1 param → 200401404410429422
GET
/v0/batch/download/{user_id}/{job_id}/{filename}
Download Batch File With Basic Auth
download_batch_file_with_basic_auth_v0_batch_download__user_id___job_id___filename__get 3 params → 200401404410429422
GET
/v0/batch/display
Get Batch Job Display Mappings
get_batch_job_display_mappings_v0_batch_display_get 1 param → 200429422
POST
/v0/batch/quote_job
Quote Batch Request
quote_batch_request_v0_batch_quote_job_post 16 params → 200422
POST
/v0/batch/quote_user_job
Quote User Batch Request
quote_user_batch_request_v0_batch_quote_user_job_post 16 params → 200422

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are BatchJobDescription (19 properties), Body_submit_batch_request_with_basic_auth_v0_batch_submit_job_post (19 properties), InstrumentDescription (10 properties), BatchQuoteJobResponse (8 properties). Each schema is shown below with its type and property counts.

Error
object
2 properties
BatchQuoteJobResponse
object
8 properties 8 required
Body_submit_batch_request_with_basic_auth_v0_batch_submit_job_post
object
19 properties 5 required
HTTPValidationError
object
1 property
BatchFileDetails
object
4 properties 2 required
InstrumentDescription
object
10 properties 3 required
ValidationError
object
3 properties 3 required
BatchJobDescription
object
19 properties 10 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

databento-batch-api-openapi.yml Raw ↑

Other APIs Databento publishes across the network.

Databento Metadata API
Databento Symbology API
Databento Live Streaming API
Databento Reference API
Databento Adjustment Factors API
Databento Analytics API
Databento Auth API
Databento Billing API
Databento Corporate Actions API
Databento OpenAPI Specification API
Databento Dataset API
Databento Display API
Where this information came from

This is an independent, third-party profile of Databento Batch API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.