Bitstamp

App · 12 actions

Read Bitstamp's public market data: the price and last 24 hours of any market or all of them at once, this hour's trading, the order book, recent trades, price candles, the markets and currencies Bitstamp lists, its EUR/USD rate, and for its perpetual futures the funding rate, past funding and index hours. Start a workflow when a price crosses a level or a large trade goes through. No account or API key required.

Actions

ActionWhat it does
Get EUR/USD conversion rateGet the rates Bitstamp changes euros and US dollars at: what one euro costs in dollars, what it gives, and the gap between them.
Get funding rateGet a Bitstamp perpetual's current funding rate (what long positions pay short ones, or the other way when negative) and when it is next paid.
Get order bookGet the best buy and sell orders waiting on a Bitstamp market, to a chosen depth, with the best bid and ask, the spread, the mid price and how much is on offer on each side.
Get priceGet a Bitstamp market's last price, best bid and ask, and its last 24 hours: the price 24 hours ago, high, low, average price, volume and change.
Get price candlesGet a Bitstamp market's price candles (OHLC: open, high, low, close and volume) of 1 minute to 3 days each, the latest or between two times, oldest first, with the change across them.
Get this hour's priceGet a Bitstamp market's last price, best bid and ask, and its trading this hour so far (since the top of the hour, UTC): the first price this hour, high, low, average price, volume and change.
List currenciesList the currencies Bitstamp holds, crypto and fiat, with their symbols, decimals and circulating supply, whether deposits and withdrawals are on, and the networks each moves on with their smallest withdrawal.
List marketsList the markets Bitstamp trades, spot and perpetual, with their base and quote currencies, smallest and largest orders, decimals and whether trading is open, and for a perpetual its index, contract size and leverage.
List past funding ratesList a Bitstamp perpetual's past funding payments, oldest first, up to 30 days back, optionally between two times, with their average.
List perpetual market hoursSee when the price index behind a Bitstamp perpetual on a traditional asset (gold, silver, oil, a stock fund, EUR/USD) is published: whether it is now, when it next opens and closes, and the schedule for the next 30 days.
List pricesGet the price and last 24 hours of every Bitstamp market in one step, or only some: chosen markets, one base or quote currency, spot or perpetual.
List recent tradesList a Bitstamp market's trades from the last minute, hour or 24 hours, newest first, optionally only buys or sells, or only trades of at least an amount or a value, with the period's volume, buy and sell volume, average price, high and low.

Get EUR/USD conversion rate

Get the rates Bitstamp changes euros and US dollars at: what one euro costs in dollars, what it gives, and the gap between them.

Inputs

None.

Outputs

buynumber
US dollars Bitstamp asks for one euro, when buying euros.
midnumber
Halfway between the two.
sellnumber
US dollars Bitstamp gives for one euro, when selling euros.
spread_percentnumber
The gap between them as a percentage of the mid.
Example output
{
  "buy": 1.15927471,
  "mid": 1.11929985,
  "sell": 1.079325,
  "spread_percent": 7.1428
}

Get funding rate

Get a Bitstamp perpetual's current funding rate (what long positions pay short ones, or the other way when negative) and when it is next paid.

Inputs

MarketmarkettextRequired
The perpetual future, such as BTC/USD perpetual (btcusd-perp). Only perpetuals have funding rates.

Outputs

funding_ratenumber
The funding rate as a fraction, such as 0.000055. When positive, long positions pay short ones.
funding_rate_percentnumber
The funding rate as a percentage, such as 0.0055.
markettext
The market's Bitstamp symbol, such as 'btcusd' for BTC/USD or 'btcusd-perp' for the BTC/USD perpetual. Every action that takes a market accepts it.
market_nametext
The market's name, such as 'BTC/USD' or 'BTC/USD-PERP'.
next_funding_timetext
When funding is next paid, in ISO 8601 (UTC).
next_funding_timestampnumber
When funding is next paid, in Unix seconds.
timetext
When Bitstamp gave this answer, in ISO 8601 (UTC).
timestampnumber
When Bitstamp gave this answer, in Unix seconds.
Example output
{
  "funding_rate": 5.1e-05,
  "funding_rate_percent": 0.0051,
  "market": "btcusd-perp",
  "market_name": "BTC/USD-PERP",
  "next_funding_time": "2026-10-24T08:00:00Z",
  "next_funding_timestamp": 1792828800,
  "time": "2026-10-24T00:11:31Z",
  "timestamp": 1792800691
}

Get order book

Get the best buy and sell orders waiting on a Bitstamp market, to a chosen depth, with the best bid and ask, the spread, the mid price and how much is on offer on each side.

Inputs

MarketmarkettextRequired
The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.
Depthdepthnumber
How many rows of each side to give, best first, from 1 to 500.From 1 to 500. Default: 20.
Groupinggroupingtext
Orders at the same price added together into one row, or each order on its own, optionally with its order ID.One of: price (Orders at the same price added together), orders (Each order on its own), orders_with_ids (Each order on its own, with its order ID). Default: price.

Outputs

ask_amountnumber
The sell rows listed here added up, in the base currency.
ask_countnumber
How many sell rows are listed here (up to the depth).
ask_rows_in_booknumber
How many sell rows the whole book has.
ask_valuenumber
The sell rows listed here added up, in the quote currency.
askslist
Sell orders, best (lowest price) first.
best_asknumber
The lowest price someone will sell at.
best_bidnumber
The highest price someone will buy at.
bid_amountnumber
The buy rows listed here added up, in the base currency.
bid_countnumber
How many buy rows are listed here (up to the depth).
bid_rows_in_booknumber
How many buy rows the whole book has.
bid_valuenumber
The buy rows listed here added up, in the quote currency.
bidslist
Buy orders, best (highest price) first.
groupingtext
'price' (orders at one price added together), 'orders' or 'orders_with_ids'.
markettext
The market's Bitstamp symbol, such as 'btcusd' for BTC/USD or 'btcusd-perp' for the BTC/USD perpetual. Every action that takes a market accepts it.
mid_pricenumber
Halfway between the best bid and the best ask.
spreadnumber
The best ask minus the best bid.
spread_percentnumber
The spread as a percentage of the mid price.
timetext
When Bitstamp gave this answer, in ISO 8601 (UTC).
timestampnumber
When Bitstamp gave this answer, in Unix seconds.
Example output
{
  "ask_amount": 0.90803501,
  "ask_count": 3,
  "ask_rows_in_book": 3790,
  "ask_value": 73480.07418597,
  "asks": [
    {
      "amount": 0.61818933,
      "order_id": null,
      "price": 80921.77,
      "value": 50024.97477871
    },
    {
      "amount": 0.20592248,
      "order_id": null,
      "price": 80922.0,
      "value": 16663.65892656
    },
    {
      "amount": 0.0839232,
      "order_id": null,
      "price": 80924.47,
      "value": 6791.4404807
    }
  ],
  "best_ask": 80921.77,
  "best_bid": 80921.76,
  "bid_amount": 0.87770707,
  "bid_count": 3,
  "bid_rows_in_book": 3375,
  "bid_value": 71025.43213765,
  "bids": [
    {
      "amount": 0.69221675,
      "order_id": null,
      "price": 80921.76,
      "value": 56015.39771148
    },
    {
      "amount": 0.00013,
      "order_id": null,
      "price": 80921.35,
      "value": 10.5197755
    },
    {
      "amount": 0.18536032,
      "order_id": null,
      "price": 80920.85,
      "value": 14999.51465067
    }
  ],
  "grouping": "price",
  "market": "btcusd",
  "mid_price": 80921.765,
  "spread": 0.01,
  "spread_percent": 1.2e-05,
  "time": "2026-10-24T00:11:29Z",
  "timestamp": 1792800689
}

Get price

Get a Bitstamp market's last price, best bid and ask, and its last 24 hours: the price 24 hours ago, high, low, average price, volume and change. A perpetual also gives its mark price, index price and open interest.

Inputs

MarketmarkettextRequired
The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.

Outputs

asknumber
The best (lowest) sell order's price.
bidnumber
The best (highest) buy order's price.
change_24hnumber
The last price minus the price 24 hours ago.
high_24hnumber
The highest price in the last 24 hours.
index_pricenumber
For a perpetual, the price of the reference index it follows; empty for a spot market.
last_pricenumber
The price of the last trade, in the quote currency.
last_trade_sidetext
'buy' when the buyer took a resting sell order (the price ticked at the ask), or 'sell' when the seller took a resting buy order.
low_24hnumber
The lowest price in the last 24 hours.
mark_pricenumber
For a perpetual, the mark price Bitstamp values positions at; empty for a spot market.
markettext
The market's Bitstamp symbol, such as 'btcusd' for BTC/USD or 'btcusd-perp' for the BTC/USD perpetual. Every action that takes a market accepts it.
market_typetext
'spot', or 'perpetual' for a perpetual future.
open_24hnumber
The price 24 hours ago.
open_interestnumber
For a perpetual, the open positions in the base currency; empty for a spot market.
open_interest_valuenumber
For a perpetual, the open positions' value in the quote currency.
open_todaynumber
The first price of the day (since midnight UTC).
percent_change_24hnumber
The change over 24 hours as a percentage, such as -0.28.
spreadnumber
The ask minus the bid.
timetext
When Bitstamp gave this answer, in ISO 8601 (UTC).
timestampnumber
When Bitstamp gave this answer, in Unix seconds.
volume_24hnumber
How much was traded in the last 24 hours, in the base currency.
volume_value_24hnumber
What the last 24 hours' trades were worth, in the quote currency (volume times the weighted average price).
vwap_24hnumber
The average price of the last 24 hours' trades, weighted by their size.
Example output
{
  "ask": 80921.77,
  "bid": 80921.76,
  "change_24h": -163.58,
  "high_24h": 81941.06,
  "index_price": null,
  "last_price": 80921.77,
  "last_trade_side": "buy",
  "low_24h": 80420.01,
  "mark_price": null,
  "market": "btcusd",
  "market_type": "spot",
  "open_24h": 81085.35,
  "open_interest": null,
  "open_interest_value": null,
  "open_today": 81076.46,
  "percent_change_24h": -0.2,
  "spread": 0.01,
  "time": "2026-10-24T00:11:29Z",
  "timestamp": 1792800689,
  "volume_24h": 1474.02976997,
  "volume_value_24h": 119994100.96,
  "vwap_24h": 81405.48
}

Get price candles

Get a Bitstamp market's price candles (OHLC: open, high, low, close and volume) of 1 minute to 3 days each, the latest or between two times, oldest first, with the change across them.

Inputs

MarketmarkettextRequired
The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.
Candle lengthsteptext
How long each candle is.One of: 60 (1 minute), 180 (3 minutes), 300 (5 minutes), 900 (15 minutes), 1800 (30 minutes), 3600 (1 hour), 7200 (2 hours), 14400 (4 hours), 21600 (6 hours), 43200 (12 hours), 86400 (1 day), 259200 (3 days). Default: 3600.
Limitlimitnumber
How many candles, up to 1,000. Leave empty for 100, or, with both a start and an end, for every candle between them.From 1 to 1000.
Startstartdate and time
The first candle is the one holding this time. Leave empty for the latest candles.
Endenddate and time
The last candle is the one holding this time. On its own, gives the candles up to it.
Leave out the open candleexclude_currenttrue/false
Leave out the candle still forming, so every candle is complete.Default: false.

Outputs

candleslist
The candles, oldest first.
changenumber
The last close minus the first open.
closenumber
The last candle's close.
countnumber
How many candles there are.
highnumber
The highest price across the candles.
lownumber
The lowest price across the candles.
markettext
The market's Bitstamp symbol, such as 'btcusd' for BTC/USD or 'btcusd-perp' for the BTC/USD perpetual. Every action that takes a market accepts it.
market_nametext
The market's name, such as 'BTC/USD' or 'BTC/USD-PERP'.
opennumber
The first candle's open.
percent_changenumber
The change as a percentage of the first open.
steptext
Each candle's length, such as '1 hour'.
step_secondsnumber
Each candle's length, in seconds.
volumenumber
Everything traded across the candles, in the base currency.
Example output
{
  "candles": [
    {
      "close": 81279.46,
      "high": 81393.84,
      "low": 81239.42,
      "open": 81304.44,
      "time": "2026-10-23T21:00:00Z",
      "timestamp": 1792789200,
      "volume": 19.77656677
    },
    {
      "close": 80739.44,
      "high": 81334.75,
      "low": 80479.38,
      "open": 81304.39,
      "time": "2026-10-23T22:00:00Z",
      "timestamp": 1792792800,
      "volume": 140.5734435
    },
    {
      "close": 81076.46,
      "high": 81092.77,
      "low": 80420.01,
      "open": 80732.17,
      "time": "2026-10-23T23:00:00Z",
      "timestamp": 1792796400,
      "volume": 76.93954195
    }
  ],
  "change": -227.98,
  "close": 81076.46,
  "count": 3,
  "high": 81393.84,
  "low": 80420.01,
  "market": "btcusd",
  "market_name": "BTC/USD",
  "open": 81304.44,
  "percent_change": -0.28,
  "step": "1 hour",
  "step_seconds": 3600,
  "volume": 237.28955222
}

Get this hour's price

Get a Bitstamp market's last price, best bid and ask, and its trading this hour so far (since the top of the hour, UTC): the first price this hour, high, low, average price, volume and change.

Inputs

MarketmarkettextRequired
The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.

Outputs

asknumber
The best (lowest) sell order's price.
bidnumber
The best (highest) buy order's price.
change_hournumber
The last price minus the first price this hour.
high_hournumber
The highest price this hour.
hour_started_attext
The top of the hour these figures start from, in ISO 8601 (UTC).
index_pricenumber
For a perpetual, the price of the reference index it follows; empty for a spot market.
last_pricenumber
The price of the last trade, in the quote currency.
last_trade_sidetext
'buy' when the buyer took a resting sell order (the price ticked at the ask), or 'sell' when the seller took a resting buy order.
low_hournumber
The lowest price this hour.
mark_pricenumber
For a perpetual, the mark price Bitstamp values positions at; empty for a spot market.
markettext
The market's Bitstamp symbol, such as 'btcusd' for BTC/USD or 'btcusd-perp' for the BTC/USD perpetual. Every action that takes a market accepts it.
market_typetext
'spot', or 'perpetual' for a perpetual future.
open_hournumber
The first price this hour (since the top of the hour, UTC).
open_interestnumber
For a perpetual, the open positions in the base currency; empty for a spot market.
open_interest_valuenumber
For a perpetual, the open positions' value in the quote currency.
percent_change_hournumber
The change this hour as a percentage.
spreadnumber
The ask minus the bid.
timetext
When Bitstamp gave this answer, in ISO 8601 (UTC).
timestampnumber
When Bitstamp gave this answer, in Unix seconds.
volume_hournumber
How much was traded this hour, in the base currency.
vwap_hournumber
The average price of this hour's trades, weighted by their size.
Example output
{
  "ask": 80921.77,
  "bid": 80921.76,
  "change_hour": -154.69,
  "high_hour": 81101.44,
  "hour_started_at": "2026-10-24T00:00:00Z",
  "index_price": null,
  "last_price": 80921.77,
  "last_trade_side": "buy",
  "low_hour": 80921.77,
  "mark_price": null,
  "market": "btcusd",
  "market_type": "spot",
  "open_hour": 81076.46,
  "open_interest": null,
  "open_interest_value": null,
  "percent_change_hour": -0.19,
  "spread": 0.01,
  "time": "2026-10-24T00:11:29Z",
  "timestamp": 1792800689,
  "volume_hour": 4.78499167,
  "vwap_hour": 81035.24
}

List currencies

List the currencies Bitstamp holds, crypto and fiat, with their symbols, decimals and circulating supply, whether deposits and withdrawals are on, and the networks each moves on with their smallest withdrawal.

Inputs

Kindcurrency_typetext
Only crypto, or only fiat money. Leave empty for both.One of: crypto, fiat (Fiat money).

Outputs

countnumber
How many currencies are listed.
currencieslist
The currencies, in Bitstamp's order.
Example output
{
  "count": 2,
  "currencies": [
    {
      "available_supply": 19934406.0,
      "code": "BTC",
      "decimals": 8,
      "deposit_enabled": true,
      "logo_url": "https://assets.bitstamp.net/assets/logos/btc.svg",
      "name": "Bitcoin",
      "networks": [
        {
          "deposit_enabled": true,
          "network": "bitcoin",
          "withdrawal_decimals": 8,
          "withdrawal_enabled": true,
          "withdrawal_minimum_amount": 6e-05
        },
        {
          "deposit_enabled": false,
          "network": "xrpl",
          "withdrawal_decimals": 8,
          "withdrawal_enabled": false,
          "withdrawal_minimum_amount": null
        }
      ],
      "symbol": "\u20bf",
      "type": "crypto",
      "withdrawal_enabled": true
    },
    {
      "available_supply": null,
      "code": "EUR",
      "decimals": 2,
      "deposit_enabled": true,
      "logo_url": "https://assets.bitstamp.net/assets/logos/eur.svg",
      "name": "Euro",
      "networks": [
        {
          "deposit_enabled": false,
          "network": "xrpl",
          "withdrawal_decimals": 2,
          "withdrawal_enabled": false,
          "withdrawal_minimum_amount": null
        }
      ],
      "symbol": "\u20ac",
      "type": "fiat",
      "withdrawal_enabled": true
    }
  ]
}

List markets

List the markets Bitstamp trades, spot and perpetual, with their base and quote currencies, smallest and largest orders, decimals and whether trading is open, and for a perpetual its index, contract size and leverage.

Inputs

Market typemarket_typetext
Only spot markets, or only perpetual futures. Leave empty for both.One of: spot (Spot markets), perpetual (Perpetual futures).
Base currencybase_currencytext
Only markets trading this currency, such as BTC for BTC/USD and BTC/EUR. Leave empty for every currency.
Quote currencyquote_currencytext
Only markets priced in this currency, such as USD for BTC/USD and ETH/USD. Leave empty for every currency.
Only markets open for tradingtrading_onlytrue/false
Leave out markets whose trading is paused.Default: false.

Outputs

countnumber
How many match the filters.
marketslist
The markets, spot first, each by name.
totalnumber
How many markets Bitstamp has.
Example output
{
  "count": 3,
  "markets": [
    {
      "asset_class": null,
      "base_currency": "BTC",
      "base_decimals": 8,
      "contract_size": null,
      "description": "Bitcoin / Euro",
      "has_market_hours": false,
      "instant_and_market_orders_enabled": true,
      "market": "btceur",
      "market_type": "spot",
      "max_leverage": null,
      "maximum_order_amount": null,
      "maximum_order_value": null,
      "minimum_order_amount": null,
      "minimum_order_value": 10.0,
      "name": "BTC/EUR",
      "quote_currency": "EUR",
      "quote_decimals": 2,
      "trading_enabled": true,
      "underlying_asset": null
    },
    {
      "asset_class": null,
      "base_currency": "BTC",
      "base_decimals": 8,
      "contract_size": null,
      "description": "Bitcoin / EURC",
      "has_market_hours": false,
      "instant_and_market_orders_enabled": false,
      "market": "btceurc",
      "market_type": "spot",
      "max_leverage": null,
      "maximum_order_amount": null,
      "maximum_order_value": null,
      "minimum_order_amount": null,
      "minimum_order_value": 10.0,
      "name": "BTC/EURC",
      "quote_currency": "EURC",
      "quote_decimals": 2,
      "trading_enabled": true,
      "underlying_asset": null
    },
    {
      "asset_class": null,
      "base_currency": "BTC",
      "base_decimals": 8,
      "contract_size": null,
      "description": "Bitcoin / EUR CoinVertible",
      "has_market_hours": false,
      "instant_and_market_orders_enabled": true,
      "market": "btceurcv",
      "market_type": "spot",
      "max_leverage": null,
      "maximum_order_amount": null,
      "maximum_order_value": null,
      "minimum_order_amount": null,
      "minimum_order_value": 10.0,
      "name": "BTC/EURCV",
      "quote_currency": "EURCV",
      "quote_decimals": 2,
      "trading_enabled": true,
      "underlying_asset": null
    }
  ],
  "total": 276
}

List past funding rates

List a Bitstamp perpetual's past funding payments, oldest first, up to 30 days back, optionally between two times, with their average.

Inputs

MarketmarkettextRequired
The perpetual future, such as BTC/USD perpetual (btcusd-perp). Only perpetuals have funding rates.
Fromsincedate and time
Only payments from this time on, up to 30 days ago. Leave empty for the latest.
Untiluntildate and time
Only payments up to this time.
Limitlimitnumber
At most this many, from 1 to 100. Leave empty for 100. Funding is paid every 8 hours.From 1 to 100.

Outputs

average_ratenumber
Their average rate, as a fraction.
average_rate_percentnumber
Their average rate, as a percentage.
countnumber
How many funding payments are listed.
markettext
The market's Bitstamp symbol, such as 'btcusd' for BTC/USD or 'btcusd-perp' for the BTC/USD perpetual. Every action that takes a market accepts it.
market_nametext
The market's name, such as 'BTC/USD' or 'BTC/USD-PERP'.
rateslist
The funding payments, oldest first.
Example output
{
  "average_rate": 7.86667e-05,
  "average_rate_percent": 0.007867,
  "count": 3,
  "market": "btcusd-perp",
  "market_name": "BTC/USD-PERP",
  "rates": [
    {
      "funding_rate": 9.2e-05,
      "funding_rate_percent": 0.0092,
      "time": "2026-10-23T08:00:00Z",
      "timestamp": 1792742400
    },
    {
      "funding_rate": 8.9e-05,
      "funding_rate_percent": 0.0089,
      "time": "2026-10-23T16:00:00Z",
      "timestamp": 1792771200
    },
    {
      "funding_rate": 5.5e-05,
      "funding_rate_percent": 0.0055,
      "time": "2026-10-24T00:00:00Z",
      "timestamp": 1792800000
    }
  ]
}

List perpetual market hours

See when the price index behind a Bitstamp perpetual on a traditional asset (gold, silver, oil, a stock fund, EUR/USD) is published: whether it is now, when it next opens and closes, and the schedule for the next 30 days. The perpetual itself trades around the clock.

Inputs

Marketmarkettext
One perpetual, such as GOLD/USD perpetual. Leave empty for every perpetual that has market hours.

Outputs

countnumber
How many markets are listed.
marketslist
Each perpetual with market hours.
Example output
{
  "count": 1,
  "markets": [
    {
      "current_close": null,
      "current_open": null,
      "index_publishing_now": false,
      "market": "goldusd-perp",
      "market_name": "GOLD/USD-PERP",
      "next_close": "2026-10-26T21:00:00Z",
      "next_open": "2026-10-25T22:00:00Z",
      "schedule": [
        {
          "end": "2026-10-25T22:00:00Z",
          "publishing": false,
          "start": "2026-10-24T00:11:31Z"
        },
        {
          "end": "2026-10-26T21:00:00Z",
          "publishing": true,
          "start": "2026-10-25T22:00:00Z"
        },
        {
          "end": "2026-10-26T22:00:00Z",
          "publishing": false,
          "start": "2026-10-26T21:00:00Z"
        }
      ],
      "trading_hours": "24/7"
    }
  ]
}

List prices

Get the price and last 24 hours of every Bitstamp market in one step, or only some: chosen markets, one base or quote currency, spot or perpetual. Sort by name, biggest rise, biggest fall or trading value, to find the day's top movers.

Inputs

Marketsmarketslist
Only these markets. Leave empty for every market.
Base currencybase_currencytext
Only markets trading this currency, such as BTC for BTC/USD and BTC/EUR. Leave empty for every currency.
Quote currencyquote_currencytext
Only markets priced in this currency, such as USD for BTC/USD and ETH/USD. Leave empty for every currency.
Market typemarket_typetext
Only spot markets, or only perpetual futures. Leave empty for both.One of: spot (Spot markets), perpetual (Perpetual futures).
Sort bysort_bytext
The order to list them in. Trading value is the last 24 hours' volume times its average price, in the quote currency.One of: market (Market name, A to Z), gainers (Biggest 24 hour rise first), losers (Biggest 24 hour fall first), volume (Most traded first, by 24 hour value). Default: market.
Limitlimitnumber
List at most this many, after sorting, such as 10 for the top ten. Leave empty for all of them.From 1 to 500.

Outputs

countnumber
How many are listed here (up to the limit).
matchednumber
How many of them match the filters.
not_foundlist
Markets asked for that Bitstamp doesn't have.
tickerslist
Each market's ticker, in the order asked for.
totalnumber
How many markets Bitstamp has.
Example output
{
  "count": 3,
  "matched": 136,
  "not_found": [],
  "tickers": [
    {
      "ask": 80921.77,
      "base_currency": "BTC",
      "bid": 80921.76,
      "change_24h": -172.15,
      "high_24h": 81941.06,
      "index_price": null,
      "last_price": 80921.77,
      "last_trade_side": "buy",
      "low_24h": 80420.01,
      "mark_price": null,
      "market": "btcusd",
      "market_name": "BTC/USD",
      "market_type": "spot",
      "open_24h": 81093.92,
      "open_interest": null,
      "open_interest_value": null,
      "open_today": 81076.46,
      "percent_change_24h": -0.21,
      "quote_currency": "USD",
      "spread": 0.01,
      "time": "2026-10-24T00:11:28Z",
      "timestamp": 1792800688,
      "volume_24h": 1475.4457591,
      "volume_value_24h": 120108927.6,
      "vwap_24h": 81405.18
    },
    {
      "ask": 0.99871,
      "base_currency": "USDT",
      "bid": 0.9987,
      "change_24h": -2e-05,
      "high_24h": 0.9989,
      "index_price": null,
      "last_price": 0.9987,
      "last_trade_side": "sell",
      "low_24h": 0.99853,
      "mark_price": null,
      "market": "usdtusd",
      "market_name": "USDT/USD",
      "market_type": "spot",
      "open_24h": 0.99872,
      "open_interest": null,
      "open_interest_value": null,
      "open_today": 0.9987,
      "percent_change_24h": 0.0,
      "quote_currency": "USD",
      "spread": 1e-05,
      "time": "2026-10-24T00:11:28Z",
      "timestamp": 1792800688,
      "volume_24h": 25708501.46357,
      "volume_value_24h": 25675851.67,
      "vwap_24h": 0.99873
    },
    {
      "ask": 2380.25,
      "base_currency": "ETH",
      "bid": 2380.24,
      "change_24h": 0.7,
      "high_24h": 2414.07,
      "index_price": null,
      "last_price": 2381.11,
      "last_trade_side": "sell",
      "low_24h": 2350.0,
      "mark_price": null,
      "market": "ethusd",
      "market_name": "ETH/USD",
      "market_type": "spot",
      "open_24h": 2380.41,
      "open_interest": null,
      "open_interest_value": null,
      "open_today": 2384.26,
      "percent_change_24h": 0.03,
      "quote_currency": "USD",
      "spread": 0.01,
      "time": "2026-10-24T00:11:28Z",
      "timestamp": 1792800688,
      "volume_24h": 9316.26389,
      "volume_value_24h": 22321209.3,
      "vwap_24h": 2395.94
    }
  ],
  "total": 276
}

List recent trades

List a Bitstamp market's trades from the last minute, hour or 24 hours, newest first, optionally only buys or sells, or only trades of at least an amount or a value, with the period's volume, buy and sell volume, average price, high and low.

Inputs

MarketmarkettextRequired
The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.
Periodperiodtext
How far back to look.One of: minute (The last minute), hour (The last hour), day (The last 24 hours). Default: hour.
Sidesidetext
Only buys (a buyer took a resting sell order) or only sells. Leave empty for both.One of: buy (Buys only), sell (Sells only).
Minimum amountmin_amountnumber
Only trades of at least this much of the base currency, such as 1 for 1 BTC on BTC/USD.At least 0.
Minimum valuemin_valuenumber
Only trades worth at least this much in the quote currency, such as 50000 for $50,000 on BTC/USD.At least 0.
Limitlimitnumber
List at most this many trades, from 1 to 1,000.From 1 to 1000. Default: 100.

Outputs

average_pricenumber
The period's average price, weighted by each trade's size.
buy_volumenumber
What buyers took in the period, in the base currency.
countnumber
How many are listed here (up to the limit).
highnumber
The highest price traded in the period.
lownumber
The lowest price traded in the period.
markettext
The market's Bitstamp symbol, such as 'btcusd' for BTC/USD or 'btcusd-perp' for the BTC/USD perpetual. Every action that takes a market accepts it.
matchednumber
How many of them match the side and minimums.
periodtext
'minute', 'hour' or 'day': how far back it read.
sell_volumenumber
What sellers took in the period, in the base currency.
totalnumber
How many trades there were in the period.
tradeslist
The matching trades, newest first.
volumenumber
Everything traded in the period, in the base currency.
Example output
{
  "average_price": 80867.00123894,
  "buy_volume": 36.18885974,
  "count": 3,
  "high": 81101.44,
  "low": 80420.01,
  "market": "btcusd",
  "matched": 67,
  "period": "hour",
  "sell_volume": 9.99373022,
  "total": 1015,
  "trades": [
    {
      "amount": 0.365641,
      "price": 80984.4,
      "side": "sell",
      "time": "2026-10-24T00:07:13Z",
      "timestamp": 1792800433,
      "trade_id": "660050612",
      "value": 29611.2170004
    },
    {
      "amount": 0.4,
      "price": 81004.65,
      "side": "sell",
      "time": "2026-10-24T00:07:13Z",
      "timestamp": 1792800433,
      "trade_id": "660050601",
      "value": 32401.86
    },
    {
      "amount": 0.30027786,
      "price": 81008.7,
      "side": "sell",
      "time": "2026-10-24T00:07:13Z",
      "timestamp": 1792800433,
      "trade_id": "660050575",
      "value": 24325.11907738
    }
  ],
  "volume": 46.18258996
}

On this page