What is a perpetual futures data API?
A perpetual futures data API delivers live prices for perpetual contracts, which are futures with no expiry date that trade around the clock. The TickerLayer Perpetuals feed returns the best bid and ask, the mark price and the last trades for each contract over REST and WebSocket, as one composite price built from multiple independent market sources.
Which perpetual contracts are covered?
The feed covers 265 perpetual contracts across seven underlying classes: 164 stocks, 38 ETFs, 8 commodities, 6 indices, 3 currency pairs, 2 pre-IPO companies and 44 crypto assets. Symbols keep their familiar contract form, for example XAUUSDT for gold, TSMUSDT for Taiwan Semiconductor and BTCUSDT for Bitcoin. The full list is on the symbols page and at GET /perpetuals/symbols.
Does the feed really run on weekends and overnight?
Yes. Perpetual contracts trade 24 hours a day, 7 days a week, so the feed keeps quoting through the night, the weekend and public holidays. A stock exchange is open for its regular session about 32.5 of the 168 hours in a week. For the other 135 hours, a perpetual on that stock is often the only live price there is.
How is the composite price calculated?
Each contract is priced from several independent market sources at once. The composite bid is the median of the live source bids and the composite ask is the median of the live source asks, so one source misbehaving cannot move the price and the book can never be crossed. Every message carries a source_count, the number of sources behind that price.
What is a mark price, and why is it a separate stream?
The mark price is the reference price a perpetual market uses to value open positions and trigger liquidations. It is smoother than the last trade and harder to push around. Risk engines, liquidation monitors and oracle networks usually want the mark rather than the top of book, so it has its own channel, perpetuals.marks, and its own REST route.
Are historical bars available for perpetual contracts?
Yes. GET /perpetuals/agg returns OHLCV bars at 1, 5 and 15 minutes, 1 and 4 hours, and 1 day, on the same aggregates contract as every other feed, and the snapshot carries the previous UTC daily close with the change against it. Weekends are in the series, because the contract traded through them. History starts when a contract was first listed, which for many perpetuals is recent, and bars are built from traded prices on the contract's primary market source.
Is a stock perpetual price the same as the stock price?
No. A perpetual is a derivative that tracks its underlying, not the underlying itself: it carries no ownership, voting or dividend rights, and its price can sit above or below the share, most of all at night and on weekends when the stock exchange is closed and the contract is the only market trading. TickerLayer publishes the data only. It does not list, offer or trade any contract, and it is not affiliated with the companies, funds or indices the contracts reference.
Is WebSocket streaming included?
Streaming is part of the Business plan. It opens three channels: perpetuals.quotes for the top of book, perpetuals.marks for mark prices and perpetuals.trades for executions, with up to 10 connections and no symbol cap. The Individual plan is REST only, with 250,000 calls a month, which suits research, dashboards that poll, and end-of-day jobs.
Can I see the price from each market source separately?
The standard feed is source neutral: one normalized price per contract. Source-level streams, where every quote and mark arrives per source with its native symbol and currency, are available to enterprise users such as oracle networks and quantitative desks that run their own aggregation. Talk to our team to set it up.
What can I build with 24/7 perpetual market data?
Common uses are weekend and overnight price displays for stock and commodity apps, reference prices for on-chain protocols and oracle networks, front ends and analytics for perpetual trading venues, liquidation and risk monitoring that needs mark prices, and research into how weekend perpetual moves line up with the Monday open.