# Bitstamp

> 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.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/bitstamp

## Actions

### 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**

- `buy` (number): US dollars Bitstamp asks for one euro, when buying euros.
- `mid` (number): Halfway between the two.
- `sell` (number): US dollars Bitstamp gives for one euro, when selling euros.
- `spread_percent` (number): The gap between them as a percentage of the mid.

**Example output**

```json
{
  "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**

- Market (`market`, text, required): The perpetual future, such as BTC/USD perpetual (btcusd-perp). Only perpetuals have funding rates.

**Outputs**

- `funding_rate` (number): The funding rate as a fraction, such as 0.000055. When positive, long positions pay short ones.
- `funding_rate_percent` (number): The funding rate as a percentage, such as 0.0055.
- `market` (text): 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_name` (text): The market's name, such as 'BTC/USD' or 'BTC/USD-PERP'.
- `next_funding_time` (text): When funding is next paid, in ISO 8601 (UTC).
- `next_funding_timestamp` (number): When funding is next paid, in Unix seconds.
- `time` (text): When Bitstamp gave this answer, in ISO 8601 (UTC).
- `timestamp` (number): When Bitstamp gave this answer, in Unix seconds.

**Example output**

```json
{
  "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**

- Market (`market`, text, required): The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.
- Depth (`depth`, number): How many rows of each side to give, best first, from 1 to 500. From 1 to 500. Default: `20`.
- Grouping (`grouping`, text): 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_amount` (number): The sell rows listed here added up, in the base currency.
- `ask_count` (number): How many sell rows are listed here (up to the depth).
- `ask_rows_in_book` (number): How many sell rows the whole book has.
- `ask_value` (number): The sell rows listed here added up, in the quote currency.
- `asks` (list): Sell orders, best (lowest price) first.
- `best_ask` (number): The lowest price someone will sell at.
- `best_bid` (number): The highest price someone will buy at.
- `bid_amount` (number): The buy rows listed here added up, in the base currency.
- `bid_count` (number): How many buy rows are listed here (up to the depth).
- `bid_rows_in_book` (number): How many buy rows the whole book has.
- `bid_value` (number): The buy rows listed here added up, in the quote currency.
- `bids` (list): Buy orders, best (highest price) first.
- `grouping` (text): 'price' (orders at one price added together), 'orders' or 'orders_with_ids'.
- `market` (text): 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_price` (number): Halfway between the best bid and the best ask.
- `spread` (number): The best ask minus the best bid.
- `spread_percent` (number): The spread as a percentage of the mid price.
- `time` (text): When Bitstamp gave this answer, in ISO 8601 (UTC).
- `timestamp` (number): When Bitstamp gave this answer, in Unix seconds.

**Example output**

```json
{
  "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**

- Market (`market`, text, required): The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.

**Outputs**

- `ask` (number): The best (lowest) sell order's price.
- `bid` (number): The best (highest) buy order's price.
- `change_24h` (number): The last price minus the price 24 hours ago.
- `high_24h` (number): The highest price in the last 24 hours.
- `index_price` (number): For a perpetual, the price of the reference index it follows; empty for a spot market.
- `last_price` (number): The price of the last trade, in the quote currency.
- `last_trade_side` (text): '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_24h` (number): The lowest price in the last 24 hours.
- `mark_price` (number): For a perpetual, the mark price Bitstamp values positions at; empty for a spot market.
- `market` (text): 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_type` (text): 'spot', or 'perpetual' for a perpetual future.
- `open_24h` (number): The price 24 hours ago.
- `open_interest` (number): For a perpetual, the open positions in the base currency; empty for a spot market.
- `open_interest_value` (number): For a perpetual, the open positions' value in the quote currency.
- `open_today` (number): The first price of the day (since midnight UTC).
- `percent_change_24h` (number): The change over 24 hours as a percentage, such as -0.28.
- `spread` (number): The ask minus the bid.
- `time` (text): When Bitstamp gave this answer, in ISO 8601 (UTC).
- `timestamp` (number): When Bitstamp gave this answer, in Unix seconds.
- `volume_24h` (number): How much was traded in the last 24 hours, in the base currency.
- `volume_value_24h` (number): What the last 24 hours' trades were worth, in the quote currency (volume times the weighted average price).
- `vwap_24h` (number): The average price of the last 24 hours' trades, weighted by their size.

**Example output**

```json
{
  "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**

- Market (`market`, text, required): The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.
- Candle length (`step`, text): 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`.
- Limit (`limit`, number): 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.
- Start (`start`, date and time): The first candle is the one holding this time. Leave empty for the latest candles.
- End (`end`, date and time): The last candle is the one holding this time. On its own, gives the candles up to it.
- Leave out the open candle (`exclude_current`, true/false): Leave out the candle still forming, so every candle is complete. Default: `false`.

**Outputs**

- `candles` (list): The candles, oldest first.
- `change` (number): The last close minus the first open.
- `close` (number): The last candle's close.
- `count` (number): How many candles there are.
- `high` (number): The highest price across the candles.
- `low` (number): The lowest price across the candles.
- `market` (text): 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_name` (text): The market's name, such as 'BTC/USD' or 'BTC/USD-PERP'.
- `open` (number): The first candle's open.
- `percent_change` (number): The change as a percentage of the first open.
- `step` (text): Each candle's length, such as '1 hour'.
- `step_seconds` (number): Each candle's length, in seconds.
- `volume` (number): Everything traded across the candles, in the base currency.

**Example output**

```json
{
  "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**

- Market (`market`, text, required): The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.

**Outputs**

- `ask` (number): The best (lowest) sell order's price.
- `bid` (number): The best (highest) buy order's price.
- `change_hour` (number): The last price minus the first price this hour.
- `high_hour` (number): The highest price this hour.
- `hour_started_at` (text): The top of the hour these figures start from, in ISO 8601 (UTC).
- `index_price` (number): For a perpetual, the price of the reference index it follows; empty for a spot market.
- `last_price` (number): The price of the last trade, in the quote currency.
- `last_trade_side` (text): '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_hour` (number): The lowest price this hour.
- `mark_price` (number): For a perpetual, the mark price Bitstamp values positions at; empty for a spot market.
- `market` (text): 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_type` (text): 'spot', or 'perpetual' for a perpetual future.
- `open_hour` (number): The first price this hour (since the top of the hour, UTC).
- `open_interest` (number): For a perpetual, the open positions in the base currency; empty for a spot market.
- `open_interest_value` (number): For a perpetual, the open positions' value in the quote currency.
- `percent_change_hour` (number): The change this hour as a percentage.
- `spread` (number): The ask minus the bid.
- `time` (text): When Bitstamp gave this answer, in ISO 8601 (UTC).
- `timestamp` (number): When Bitstamp gave this answer, in Unix seconds.
- `volume_hour` (number): How much was traded this hour, in the base currency.
- `vwap_hour` (number): The average price of this hour's trades, weighted by their size.

**Example output**

```json
{
  "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**

- Kind (`currency_type`, text): Only crypto, or only fiat money. Leave empty for both. One of: `crypto`, `fiat` (Fiat money).

**Outputs**

- `count` (number): How many currencies are listed.
- `currencies` (list): The currencies, in Bitstamp's order.

**Example output**

```json
{
  "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 type (`market_type`, text): Only spot markets, or only perpetual futures. Leave empty for both. One of: `spot` (Spot markets), `perpetual` (Perpetual futures).
- Base currency (`base_currency`, text): Only markets trading this currency, such as BTC for BTC/USD and BTC/EUR. Leave empty for every currency.
- Quote currency (`quote_currency`, text): Only markets priced in this currency, such as USD for BTC/USD and ETH/USD. Leave empty for every currency.
- Only markets open for trading (`trading_only`, true/false): Leave out markets whose trading is paused. Default: `false`.

**Outputs**

- `count` (number): How many match the filters.
- `markets` (list): The markets, spot first, each by name.
- `total` (number): How many markets Bitstamp has.

**Example output**

```json
{
  "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**

- Market (`market`, text, required): The perpetual future, such as BTC/USD perpetual (btcusd-perp). Only perpetuals have funding rates.
- From (`since`, date and time): Only payments from this time on, up to 30 days ago. Leave empty for the latest.
- Until (`until`, date and time): Only payments up to this time.
- Limit (`limit`, number): At most this many, from 1 to 100. Leave empty for 100. Funding is paid every 8 hours. From 1 to 100.

**Outputs**

- `average_rate` (number): Their average rate, as a fraction.
- `average_rate_percent` (number): Their average rate, as a percentage.
- `count` (number): How many funding payments are listed.
- `market` (text): 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_name` (text): The market's name, such as 'BTC/USD' or 'BTC/USD-PERP'.
- `rates` (list): The funding payments, oldest first.

**Example output**

```json
{
  "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**

- Market (`market`, text): One perpetual, such as GOLD/USD perpetual. Leave empty for every perpetual that has market hours.

**Outputs**

- `count` (number): How many markets are listed.
- `markets` (list): Each perpetual with market hours.

**Example output**

```json
{
  "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**

- Markets (`markets`, list): Only these markets. Leave empty for every market.
- Base currency (`base_currency`, text): Only markets trading this currency, such as BTC for BTC/USD and BTC/EUR. Leave empty for every currency.
- Quote currency (`quote_currency`, text): Only markets priced in this currency, such as USD for BTC/USD and ETH/USD. Leave empty for every currency.
- Market type (`market_type`, text): Only spot markets, or only perpetual futures. Leave empty for both. One of: `spot` (Spot markets), `perpetual` (Perpetual futures).
- Sort by (`sort_by`, text): 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`.
- Limit (`limit`, number): 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**

- `count` (number): How many are listed here (up to the limit).
- `matched` (number): How many of them match the filters.
- `not_found` (list): Markets asked for that Bitstamp doesn't have.
- `tickers` (list): Each market's ticker, in the order asked for.
- `total` (number): How many markets Bitstamp has.

**Example output**

```json
{
  "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**

- Market (`market`, text, required): The market, such as BTC/USD. A symbol chained from an earlier step works too, written as btcusd, BTC/USD or btcusd-perp.
- Period (`period`, text): How far back to look. One of: `minute` (The last minute), `hour` (The last hour), `day` (The last 24 hours). Default: `hour`.
- Side (`side`, text): 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 amount (`min_amount`, number): Only trades of at least this much of the base currency, such as 1 for 1 BTC on BTC/USD. At least 0.
- Minimum value (`min_value`, number): Only trades worth at least this much in the quote currency, such as 50000 for $50,000 on BTC/USD. At least 0.
- Limit (`limit`, number): List at most this many trades, from 1 to 1,000. From 1 to 1000. Default: `100`.

**Outputs**

- `average_price` (number): The period's average price, weighted by each trade's size.
- `buy_volume` (number): What buyers took in the period, in the base currency.
- `count` (number): How many are listed here (up to the limit).
- `high` (number): The highest price traded in the period.
- `low` (number): The lowest price traded in the period.
- `market` (text): 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.
- `matched` (number): How many of them match the side and minimums.
- `period` (text): 'minute', 'hour' or 'day': how far back it read.
- `sell_volume` (number): What sellers took in the period, in the base currency.
- `total` (number): How many trades there were in the period.
- `trades` (list): The matching trades, newest first.
- `volume` (number): Everything traded in the period, in the base currency.

**Example output**

```json
{
  "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
}
```
