Sign in
latestOpenAPI 3.1.02026-08-145096557.0 KB

1c983de099e2

us-equity-intraday-bar

US Equities Trade and Quote Minute Bar

The U.S. Equities Trade and Quote Minute Bar dataset provides a minute-by-minute analytical view of U.S. equity market activity, derived from consolidated trade and quote (TAQ) data. Each one-minute bar contains approximately 60 calculated metrics, summarizing intraday price behavior, quote dynamics, and trading activity. In addition to standard Open, High, Low, Close, and Volume (OHLCV) measures, the dataset includes market microstructure indicators such as trade classification at bid/mid/ask, uptick and downtick statistics, bid-ask spread measures, and time-weighted bid and ask metrics. These features support intraday liquidity analysis, signal development, and short-horizon market studies without the complexity of tick-level data. The dataset uses a continuous minute-bar timeline. When no qualifying trade or quote updates occur during a given minute, the most recent bid and ask values are carried forward, ensuring a complete, gap-free time series that simplifies downstream joins and modeling. Data is derived from Equity Securities Information Processor (SIP) feeds and includes all eligible trades and top-of-book quotes, including off-exchange trades reported to FINRA Trade Reporting Facilities (TRF). Coverage spans all U.S. public-traded equity issue types, including common and preferred stocks, ETFs, ETNs, ADRs, warrants, and units.

For more details, please refer to the dataset documentation: US Equities Trade and Quote Minute Bar Guide (algoseek and Excluding FINRA TRF aggregation logic).

Aggregation Logic Options

This dataset is available with different aggregation logic variants, which may affect how certain data fields are calculated.

algoseek

algoseek core team comes from a high-frequency background and uses accepted de facto standards for calculating OHLC bars. See documentation for details on included/excluded fields.

Excluding FINRA TRF

Excludes all trades that are done off the public ("lit") exchanges.  These trades from dark pools, internal crossing, OTC deals, etc.  These are trades that are not normally possible to participate in, so they can skew the backtesting if Client is only executing on public exchanges. Removing these trades provides a more realistic view of actual trades taking place, but does lose insight into the whole market.

<details> <summary>**Advanced Filtering**</summary>

You can provide one or multiple filter expressions based on the dataset's columns to narrow down the results. For example, StartDate.gt=2023-01-01&StartDate.lt=2023-12-31, Ticker=AAPL.

Please refer to the <a href="https://algoseek.com/docs/rest-api/tutorial/advanced-filtering">Advanced Filtering Guide</a> for the extensive reference.

</details> <details> <summary>**Optimizing Performance**</summary>

Some queries to this endpoint may be slow due to the size of the data chunk requested. If this becomes an issue, consider narrowing down the response data with query parameters.

For more details, please refer to the <a href="https://algoseek.com/docs/rest-api/tutorial/optimizing-query-performance">Query Performance Guide</a>.

</details>
get/v1/data/us-equity/taq-1min/{identifier}

Path parameters

identifierstring required

Dataset's security identifier

Dataset's security identifier

Query parameters

aggregation_logic'algoseek' | 'no_finra_trf'

Aggregation logic variant of the dataset

periodstring nullable

A string representing the time period for which to retrieve data. The format and accepted values depend on the dataset. If not provided, data for all available periods will be returned.

A string representing the time period for which to retrieve data. The format and accepted values depend on the dataset. If not provided, data for all available periods will be returned.

sortstring nullable

Sorting criteria for the results. Provide a column name with optional prefix '+' for ascending order, or prefix with '-' for descending order. Multiple sorting fields may be supported depending on the dataset. If sort prefix is not provided, the ascending order is applied.

Sorting criteria for the results. Provide a column name with optional prefix '+' for ascending order, or prefix with '-' for descending order. Multiple sorting fields may be supported depending on the dataset. If sort prefix is not provided, the ascending order is applied.

columnsstring nullable

A comma-separated list of columns to include in the response. Use this parameter to select only specific fields from the dataset. If not provided, all available columns will be returned.

A comma-separated list of columns to include in the response. Use this parameter to select only specific fields from the dataset. If not provided, all available columns will be returned.

offsetinteger

Number of records to skip before returning results. To be used with the limit parameter for pagination. If not provided, defaults to 0.

Number of records to skip before returning results. To be used with the limit parameter for pagination. If not provided, defaults to 0.

limitinteger

Maximum number of records to return. Default and maximum values depend on the response format; see format_limits in the schema for details.

Maximum number of records to return. Default and maximum values depend on the response format; see format_limits in the schema for details.

response_format'json' | 'csv' | 'csv_gzip'

Note the lowercase which is used for the consistency with other projects and tools

The type of the data to return

Response

JSON, CSV file, or gzip-compressed CSV file, depending on the value of response_format query parameter

Example response

{
  "data": [
    {
      "TradeDate": "2023-08-02",
      "BarDateTime": "2023-08-02 09:30:00",
      "Ticker": "AAPL",
      "ASID": 1010000000001033,
      "OpenBidPrice": 194.98,
      "OpenBidSize": 1000,
      "OpenAskPrice": 195.1,
      "OpenAskSize": 300,
      "FirstTradeTimeOffset": 0.014475656,
      "FirstTradePrice": 195.04,
      "FirstTradeSize": 100,
      "HighBidTimeOffset": 12.135221447,
      "HighBidPrice": 195.17,
      "HighBidSize": 100,
      "HighAskTimeOffset": 1.210477396,
      "HighAskPrice": 195.19,
      "HighAskSize": 2700,
      "HighTradeTimeOffset": 1.211722289,
      "HighTradePrice": 195.18,
      "HighTradeSize": 39,
      "LowBidTimeOffset": 54.761933543,
      "LowBidPrice": 194.79,
      "LowBidSize": 500,
      "LowAskTimeOffset": 50.78799885,
      "LowAskPrice": 194.81,
      "LowAskSize": 100,
      "LowTradeTimeOffset": 50.787492243,
      "LowTradePrice": 194.8,
      "LowTradeSize": 2,
      "CloseBarTimeOffset": 59.999999999,
      "CloseBidPrice": 194.9,
      "CloseBidSize": 300,
      "CloseAskPrice": 194.92,
      "CloseAskSize": 800,
      "LastTradeTimeOffset": 59.973818199,
      "LastTradePrice": 194.91,
      "LastTradeSize": 100,
      "MinSpread": 0.01,
      "MaxSpread": 0.12,
      "VolumeWeightPrice": 194.99778,
      "NBBOQuoteCount": 10498,
      "TradeAtBid": 585766,
      "TradeAtBidMid": 31663,
      "TradeAtMid": 71547,
      "TradeAtMidAsk": 42982,
      "TradeAtAsk": 98737,
      "TradeAtCrossOrLocked": 17741,
      "Volume": 713900,
      "TotalTrades": 7183,
      "FinraVolume": 134536,
      "FinraVolumeWeightPrice": 194.98306,
      "UptickVolume": 74596,
      "DowntickVolume": 572129,
      "RepeatUptickVolume": 89084,
      "RepeatDowntickVolume": 112627,
      "TradeToMidVolWeight": -6.58991,
      "TradeToMidVolWeightRelative": -2.29876,
      "TimeWeightBid": 194.92949,
      "TimeWeightAsk": 194.95437
    }
  ],
  "pagination": {
    "limit": 1000,
    "next_offset": 2000,
    "offset": 1000
  }
}