v3.2

API Reference

RESTful API for programmatic access to market data. All responses are JSON. Authentication via API key in the Authorization header.

Base URL: https://storage.profluentresearch.com/api/v3

Authentication

# Include your API key in every request
curl -H "Authorization: Bearer pr_live_xxxxxxxxxxxxxxxx" \
     https://storage.profluentresearch.com/api/v3/datasets
        

Datasets

GET /v3/datasets List all available datasets

Parameter	Type	Description
asset_class	string	Filter by asset class: `equity`, `futures`, `options`, `fx`, `crypto`, `fixed_income`
status	string	Filter by feed status: `live`, `historical`, `deprecated`
limit	integer	Results per page (default: 25, max: 100)
offset	integer	Pagination offset

// Response
{
  "data": [
    {
      "id": "us_equities_taq",
      "name": "US Equities — Full Tick (TAQ)",
      "asset_class": "equity",
      "status": "live",
      "coverage_start": "2003-01-02",
      "size_bytes": 1319413953536000,
      "record_count": 147000000000,
      "granularity": "nanosecond"
    }
  ],
  "meta": { "total": 42, "limit": 25, "offset": 0 }
}
                

GET /v3/datasets/{dataset_id}/schema Get dataset schema and column definitions

Queries

POST /v3/query Execute a data query

Parameter	Type	Description
dataset_idrequired	string	Target dataset identifier
symbolsrequired	array	List of symbols (max 500 per query)
start	datetime	ISO 8601 start timestamp (inclusive)
end	datetime	ISO 8601 end timestamp (exclusive)
columns	array	Columns to return (default: all)
format	string	Response format: `json`, `csv`, `parquet` (default: json)
limit	integer	Max rows to return (default: 10000, max: 1000000)

// Request
{
  "dataset_id": "us_equities_taq",
  "symbols": ["AAPL", "MSFT"],
  "start": "2026-04-01T09:30:00Z",
  "end": "2026-04-01T16:00:00Z",
  "columns": ["timestamp", "price", "size", "exchange"],
  "format": "json",
  "limit": 1000
}
                

GET /v3/query/{query_id} Check async query status and retrieve results

DELETE /v3/query/{query_id} Cancel a running query

Snapshots

GET /v3/snapshot/{dataset_id}/{symbol} Latest data point for a symbol

POST /v3/snapshot/bulk Latest data points for multiple symbols

Exports

POST /v3/export Request bulk data export (S3/GCS delivery)

GET /v3/export/{export_id} Check export status and download links

Rate Limits

Standard tier: 100 requests/min, 10 concurrent queries, 10M rows/query.
Premium tier: 1000 requests/min, 50 concurrent queries, 100M rows/query.
Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response.