US Equities Trade Only
One row is one trade (or trade cancellation) printed on the SIP consolidated tape for a US-listed equity, with price, size, venue and sale-condition flags but no quotes. Used for execution, volume and trade-signal studies.
How to use it
Times are local US Eastern clock times (DST-aware), not UTC. Treat TRADE NB / NBBO-flagged rows as the backtest-grade subset. Cancellations reference earlier trades and can arrive hours later, so aggregate only after the session closes. Prices are unadjusted unless the dataset name says Adjusted; join us-equities-*-adjustment-factors on SecId for adjustment.
Typical use
Backtesting, execution and microstructure research, feature engineering for US equities.
Limitations
Delivered as recorded from the source feed: AlgoSeek does not remove crossed or locked quotes, bad prints, or out-of-sequence packets unless contracted to. Consumers own cleaning. Sample channel: S3 CSV (sample_channel s3/cloud_storage, eq_trades.csv, 100 rows, AAPL on 2023-08-02); no ArdaDB table sample for this dataset. The JSON preview is identical to the CSV. Documented EventType set: TRADE, TRADE NB, TRADE CANCELLED. Treat TRADE NB CANCELLED as an open question (documented only in the TAQ guide) before making the set strictly closed. TRADE NB is the trade type the guide recommends for backtesting; TRADE rows not at the NBBO include some FINRA TRF reports, late reports, extended-hours trades (no NBBO pre/post), ISO orders and trade-through exemptions. Cancellations reduce traded volume by their Quantity, may arrive hours after the original trade and are not adjacent to it; a correction is a cancellation followed by the corrected trade. Consumers computing volume must net them out.
Coverage
All trades on all US public equity exchanges plus off-exchange trades reported to FINRA TRFs, for listed stocks, ETNs, ETFs, ADRs and funds from 15+ exchanges and marketplaces, across the full 04:00-20:00 ET session; no quotes. History start is not stated; nanosecond timestamps from 2016, millisecond before.
Venues (23)
- NYSE
- ARCA
- AMEX
- NSE
- CSE
- Nasdaq
- Nasdaq BX
- NASDAQ PSX
- ISE
- CBOE
- BATS Y
- BATS
- EDGA
- EDGX
- IEX
- LTSE
- MIAX
- MEMX
- FINRA
- NE24X
- TXSE
- UNKNOWN
- INVALID
Answers to common questions
- What time zone are the timestamps in?
- US Eastern local time with daylight saving (the guides label it EST/ET).
- Are prices adjusted for splits and dividends?
- Only in datasets whose name contains Adjusted; all others are as traded.
Usage constraints
- Licensed vendor data: never export raw rows to a tenant-local destination or include them verbatim in a public artifact; serve only through entitlement-checked platform reads.
- Do not treat the vendor's `Ticker` as a stable identity across time; join on an AlgoSeek security key (SecId or ASID, which are distinct) or the platform symbol mapping.
Known issues (9)
- Primary key is inferred; AlgoSeek's guide does not name one.
- Documentation discrepancyConditions width/case: guide Appendix A says flags are eight-character hex and Table 1 prints them as 8 characters (80000401, a0000421); the CSV sample prints lower-case hex with leading zeros dropped (value lengths 1, 3, 7, 8 such as '1', '401', '4000001').
- Documentation discrepancyExchange spelling: guide Table 4 values 'Nasdaq', 'Nasdaq BX', 'MIAX' appear in the sample as 'NASDAQ', 'NASDAQ BX', 'MIAX PEARL'.
- Documentation discrepancyGuide text before Table 4 says '19 SIP Market Center IDs (including FINRA)' but the table lists 21 venues plus UNKNOWN and INVALID; the intro says '15+ exchanges'.
- Documentation discrepancyEventType: guide Table 3 documents three values (TRADE, TRADE NB, TRADE CANCELLED); the TAQ guide also documents TRADE NB CANCELLED. Whether this dataset can emit it is unstated; the sample has only TRADE and TRADE NB.
- Documentation discrepancyTRADE NB is 'trade at national best price' in Table 3 and 'a trade at the National Best Bid Offer' in the NBBO paragraph; the TAQ guide says 'at or within the NBBO'.
- Documentation discrepancyTime zone is labelled 'EST' while session times are local Eastern clock times; DST handling is not stated.
- Documentation discrepancyGuide Table 2 has no 'Missing' column, so null/empty behaviour is undocumented; the 100-row sample has no empty cells.
- Documentation discrepancyNo history start date is given in the guide or on the product page; the sample is one slice (AAPL, 2023-08-02, 09:30:00.014-09:30:00.657).
8 columns in delivery order · file or table name eq_trades. Types are ODCS logical types; the format line shows how values are written.
| Column | Type | Key | Description |
|---|---|---|---|
| Date | dateyyyymmdd | Key 1 · Partition · Required | Trading date of the trade, written yyyymmdd. Source: vendor guide and sample |
| Timestamp | timeHH:MM:SS.mmmuuunnn (ns) from 2016; HH:MM:SS.mmm (ms) before 2016 | Key 3 · Required | Trade time of day in US Eastern: nanosecond precision from 2016, millisecond before. Import as text, not an Excel time. Source: vendor guide and sample |
| EventType | string · enum (3) | Key 4 · Required | Kind of event: a trade, a trade at the NBBO, or a trade cancellation. Source: vendor guide and sample 3 allowed values
|
| Ticker | string | Key 2 · Partition · Required | Symbol name of the security. Source: vendor guide and sample |
| Price | number | Trade price; up to 4 decimals for sub-penny prices. Unit: USD · Source: vendor guide and sample | |
| Quantity | integeri64 | Number of shares traded; the guide notes it can be 0 for some event types. Unit: shares · Source: vendor guide and sample | |
| Exchange | string · enum (23) | Key 5 · Required | Exchange or reporting venue (algoseek venue code); FINRA marks off-exchange TRF reports. Source: vendor guide and sample 23 allowed values
|
| Conditions | stringhex uint32 bitmask, lower-case, no 0x prefix; guide examples zero-padded to 8 chars, sample drops leading zeros | Bitmask of sale-condition flags that apply to the trade, as base-16 text. Source: vendor guide and sample |
- errorrow_count_positivecompleteness
Every delivered partition (trade date, or snapshot) carries at least one row.
rowCount must be greater than 0
- warningprimary_key_uniqueuniqueness
Best-effort key for an event stream: same-timestamp events from one venue can repeat, so duplicates are reported, not rejected.
duplicateValues (properties: Date, Ticker, Timestamp, EventType, Exchange) must be 0
- errorQuantity_non_negativeaccuracy
Quantity is never negative.
SELECT COUNT(*) FROM {object} WHERE Quantity < 0 - errorconditions_hex_uint32conformity
Conditions is a hex uint32 bit mask without a 0x prefix. The guide shows 8 zero-padded characters; delivered files use lower case and drop leading zeros (e.g. 401, a0000021).
invalidValues (pattern: ^[0-9A-Fa-f]{1,8}$) must be 0
Delivery
S3 flat files
AlgoSeek flat-file delivery (the layout the schema below describes).
- Layout:
- Plain-text CSV with a fixed header row; by default one file per symbol per trading day; gzip-compressed (.csv.gz, ~8:1). The guide gives no bucket/key path for the data files; only the calendar files s3://us-equity-market-holidays/holidays.csv and earlycloses.csv are named.
- Compression:
- gzip
- Access:
- Bucket access is granted per subscription; bucket names arrive with license provisioning.
REST API
AlgoSeek Datasets REST API (X-API-KEY header; JSON, CSV or gzipped CSV). Returns AlgoSeek's normalized API layout, which differs from the flat-file columns in this contract's schema.
https://api.algoseek.com/v1/data/us-equity/trades/:trade_date/:identifier
- Authentication:
- X-API-KEY header issued by AlgoSeek
- Response formats:
- json, csv, csv_gzip
- Pagination:
- offset + limit; tick endpoints take trade_date and identifier (Ticker or ASID) in the path
Service levels
- Update frequency
- Daily
- Retention
- Bounded by the license term
- Retention of landed copies is bounded by the AlgoSeek license; purge on termination.
- History starts
- Not stated in the vendor documentation
Service levels describe the vendor feed as documented. They are draft values, not a commitment by AlphaSwarm.
Data Contract Editor · read-only preview — edits are not saved
Open-source Data Contract Editor (MIT). Changes stay in this browser tab: Cancel restores the published contract, and Download copy saves your edited YAML to your device only.
Contracts follow the Open Data Contract Standard (Bitol, LF AI & Data).
Vendor names are trademarks of their owners.