Coverage
Data available for ZB
ZB is covered by all five futures datasets. Rates traders often care most about the positioning card, since asset managers hold large long positions in bond futures.
| Data | What it is | Granularity | Delivery | Plan | Details |
|---|---|---|---|---|---|
| OHLCV bars, intraday and daily | Per-contract bars with settlement and open interest on daily rows | 1 second to 1 day | API and CSV/Parquet file | Front-month daily on Free; 1-minute from Starter | Product page |
| Continuous and back-adjusted contracts | One long series per root, raw, back-adjusted or ratio-adjusted | 1 minute to 1 day | API and file | Daily on Starter; intraday on Pro | Product page |
| Trades and L1 quotes | Every trade with aggressor side and every best bid/offer change | Each event, nanoseconds where the venue sends them | API and file | 30 days of trades on Pro; full history and L1 on Business | Product page |
| Settlement, open interest, limits | The official daily numbers the exchange publishes per contract | 1 day | API and file | Prior-day front months on Free; full history on Starter | Product page |
| CFTC Commitments of Traders | Weekly long and short positions by trader category | Weekly (Tuesday data, Friday release) | API and free bulk file | Raw reports on Free; derived fields on Starter | Product page |
Sample data
Sample data preview
Futures Positioning (CFTC Commitments of Traders)
The CFTC calls ZB UST BOND. These three rows from the free file show weekly positioning by trader type.
symbol |
date |
market |
exchange |
cftc_code |
open_interest |
dealer_long |
dealer_short |
asset_manager_long |
asset_manager_short |
leveraged_funds_long |
leveraged_funds_short |
change_in_open_interest |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ZB | 2026-10-27 | UST BOND | CHICAGO BOARD OF TRADE | 020601 | 1890568 | 44935 | 263251 | 1141449 | 757468 | 197843 | 348236 | 105111 |
| ZB | 2026-11-03 | UST BOND | CHICAGO BOARD OF TRADE | 020601 | 1930138 | 45950 | 285264 | 1164793 | 749414 | 209524 | 375781 | 39570 |
| ZB | 2026-11-10 | UST BOND | CHICAGO BOARD OF TRADE | 020601 | 1985709 | 43711 | 290102 | 1157873 | 762883 | 263868 | 413726 | 55571 |
Source: CFTC
Asset managers held more than 1.1 million long contracts in each report, while leveraged funds were net short. That's the familiar basis-trade pattern in Treasury futures.
Schema
Schema
ZB bars use this schema. Prices are stored as decimal points, and you should check how any other feed you compare against writes 32nds.
| Field | Type | Description |
|---|---|---|
symbol |
string | Contract in our format, e.g. ESZ6 |
root |
string | Product root, e.g. ES |
exchange |
string | Venue MIC or short code, e.g. CME |
interval |
string | 1s, 1m, 5m, 1h, 1d |
timestamp |
string | Bar start, ISO 8601 UTC (intraday) |
date |
string | Trading session date, YYYY-MM-DD (daily) |
session_date |
string | Trading day the bar belongs to; the Globex session opens the evening before (intraday) |
open |
number | First trade price |
high |
number | Highest trade price |
low |
number | Lowest trade price |
close |
number | Last trade price in the bar |
volume |
number | Contracts traded |
trade_count |
number | Number of trades (optional) |
vwap |
number | Volume-weighted average price (optional) |
settlement_price |
number | Official exchange settlement (daily, optional) |
open_interest |
number | Open contracts reported for the session (daily, optional) |
buy_aggressor_volume |
number | Volume where the buyer crossed the spread (optional) |
sell_aggressor_volume |
number | Volume where the seller crossed the spread (optional) |
API
Get it by API
An early access example for one Globex session of December 2026 bond futures, ZBZ6:
curl (example)
curl -G "https://api.marketdata.co/v1/futures/bars" \
-H "Authorization: Bearer $MARKETDATA_API_KEY" \
--data-urlencode "symbol=ZBZ6" \
--data-urlencode "interval=1m" \
--data-urlencode "start=2026-11-17T23:00:00Z" \
--data-urlencode "end=2026-11-18T22:00:00Z"
Python (example)
import os
import requests
import pandas as pd
resp = requests.get( # ZB minute bars, converted to 32nds
"https://api.marketdata.co/v1/futures/bars",
headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
params={"symbol": "ZBZ6", "interval": "1m",
"start": "2026-11-17T23:00:00Z", "end": "2026-11-18T22:00:00Z"},
timeout=30,
)
resp.raise_for_status()
bars = pd.DataFrame(resp.json()["results"])
bars["timestamp"] = pd.to_datetime(bars["timestamp"], utc=True)
bars["close_32nds"] = (bars["close"] % 1) * 32
print(bars[["timestamp", "close", "close_32nds"]].tail())
The Python tab converts the decimal fraction back into 32nds, the way bond traders read the price.
Datasets
Get it as a file
ZB files are priced per root:
- Formats: CSV and Parquet
- 1-minute bars: $12 per root per year, all expiries included
- Full daily history: $39 per root
- Continuous contracts: $29 per root, all three adjustments and the roll calendar
- Trades: $49 per root per year ($99 with L1 quotes)
- COT positioning: free bulk download
If you trade the curve, each extra Treasury future you add is priced the same way, per root.
Use cases
About 30-Year Treasury Bond Futures (for traders)
ZB is the CBOT 30-year US Treasury bond future. One contract covers $100,000 face value of Treasury bonds with roughly 15 to 25 years left to maturity. It's quoted in points and 32nds of a point, and one 32nd is worth $31.25.
Bond futures move inversely to long-term yields. Fed policy, inflation data, Treasury auction sizes and growth surprises are the main drivers. Long bonds react strongly to inflation expectations because of their long duration.
Globex trading runs Sunday 17:00 to Friday 16:00 Chicago time with a daily break. The busiest hours follow US data releases at 08:30 New York time.
This contract delivers physically, and the seller picks which eligible bond to deliver, usually the cheapest-to-deliver. Changes in that bond can shift ZB's behaviour. Contracts are quarterly, and most volume rolls before first notice day at the end of the month before expiry, earlier than in equity index futures.
Pricing
Pricing
These are the futures plan rows for ZB:
| Free $0 | Starter $29/mo | Pro $79/mo | Business $249/mo | |
|---|---|---|---|---|
| Daily bars | Front month, 1 year | Full history | Full history | Full history |
| Intraday bars | No | 1-minute, 10-minute delay, 5 years | 1-second to daily, delayed | Real-time WebSocket bars |
| Continuous contracts | No | Daily, all three adjustments | Adds intraday and custom roll rule | As Pro |
| Settlement and OI | Prior day, front months | Full history | Adds preliminary settlements and limits | As Pro |
| Trades and L1 quotes | No | No | Last 30 days of trades, delayed | Full history, L1 quotes, real time |
| COT positioning | All raw reports | Adds net positions and percentiles | As Starter | As Starter |
Full plan details are on the pricing page.
FAQ
Frequently asked questions
How are ZB prices quoted?
Treasury bond futures are quoted in points and 32nds, so 118-16 means 118 and 16/32. Our files store decimals (118.5), and you can convert back as in the Python example.
When does ZB roll?
Most volume moves to the next quarter before first notice day, which is near the end of the month before the contract month. That's earlier than equity index futures, which roll about eight days before expiry.
Is there free ZB data?
Yes, ZB is in the free CFTC positioning sample. Front-month daily bars are planned for the Free plan.
What time zone are ZB bars in?
UTC is used for every intraday ZB bar. The session_date field names the trading day, which starts the previous evening on Globex.
Can I get ZB data in Excel?
Yes, ZB data comes as CSV. If you want prices in 32nds, add a column in Excel or pandas as shown in the Python example.
Keep reading
Related
- All futures data
- Futures historical data
- Continuous futures data
- Futures tick data
- Other symbols: ES, NQ, YM, RTY, CL, GC
- Learn: How to read the COT report