cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 3983,
  "method": "public/get_last_trades_by_instrument_and_time",
  "params": {
    "instrument_name": "ETH-PERPETUAL",
    "end_timestamp": 1590480022768,
    "count": 1
  }
}
'

import requests

url = "https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time"

payload = {
    "jsonrpc": "2.0",
    "id": 3983,
    "method": "public/get_last_trades_by_instrument_and_time",
    "params": {
        "instrument_name": "ETH-PERPETUAL",
        "end_timestamp": 1590480022768,
        "count": 1
    }
}
headers = {"Content-Type": "application/json"}

response = requests.get(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 3983,
    method: 'public/get_last_trades_by_instrument_and_time',
    params: {instrument_name: 'ETH-PERPETUAL', end_timestamp: 1590480022768, count: 1}
  })
};

fetch('https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'id' => 3983,
    'method' => 'public/get_last_trades_by_instrument_and_time',
    'params' => [
        'instrument_name' => 'ETH-PERPETUAL',
        'end_timestamp' => 1590480022768,
        'count' => 1
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3983,\n  \"method\": \"public/get_last_trades_by_instrument_and_time\",\n  \"params\": {\n    \"instrument_name\": \"ETH-PERPETUAL\",\n    \"end_timestamp\": 1590480022768,\n    \"count\": 1\n  }\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3983,\n  \"method\": \"public/get_last_trades_by_instrument_and_time\",\n  \"params\": {\n    \"instrument_name\": \"ETH-PERPETUAL\",\n    \"end_timestamp\": 1590480022768,\n    \"count\": 1\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3983,\n  \"method\": \"public/get_last_trades_by_instrument_and_time\",\n  \"params\": {\n    \"instrument_name\": \"ETH-PERPETUAL\",\n    \"end_timestamp\": 1590480022768,\n    \"count\": 1\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "jsonrpc": "2.0",
  "id": 3983,
  "result": {
    "trades": [
      {
        "trade_seq": 1966031,
        "trade_id": "ETH-2696055",
        "timestamp": 1590479408216,
        "tick_direction": 0,
        "price": 203.6,
        "mark_price": 203.41,
        "instrument_name": "ETH-PERPETUAL",
        "index_price": 203.45,
        "direction": "buy",
        "amount": 10
      }
    ],
    "has_more": true
  }
}

Market Data

public/get_last_trades_by_instrument_and_time

Retrieves the latest trades that have occurred for a specific instrument within a specified time range. Returns trade details including price, amount, direction, timestamp, and trade ID.

Use the count parameter to limit the number of trades returned, and sorting to control the order (ascending or descending by trade ID). This method is useful for analyzing trading activity over specific time periods.

Note: For spot instruments routed to Coinbase Exchange, this call is not supported. Use Get product trades directly for full trade history.

📖 Related Article: Spot Trading: Deribit and Coinbase-Routed Instruments

Try in API console

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 3983,
  "method": "public/get_last_trades_by_instrument_and_time",
  "params": {
    "instrument_name": "ETH-PERPETUAL",
    "end_timestamp": 1590480022768,
    "count": 1
  }
}
'

import requests

url = "https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time"

payload = {
    "jsonrpc": "2.0",
    "id": 3983,
    "method": "public/get_last_trades_by_instrument_and_time",
    "params": {
        "instrument_name": "ETH-PERPETUAL",
        "end_timestamp": 1590480022768,
        "count": 1
    }
}
headers = {"Content-Type": "application/json"}

response = requests.get(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 3983,
    method: 'public/get_last_trades_by_instrument_and_time',
    params: {instrument_name: 'ETH-PERPETUAL', end_timestamp: 1590480022768, count: 1}
  })
};

fetch('https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'id' => 3983,
    'method' => 'public/get_last_trades_by_instrument_and_time',
    'params' => [
        'instrument_name' => 'ETH-PERPETUAL',
        'end_timestamp' => 1590480022768,
        'count' => 1
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3983,\n  \"method\": \"public/get_last_trades_by_instrument_and_time\",\n  \"params\": {\n    \"instrument_name\": \"ETH-PERPETUAL\",\n    \"end_timestamp\": 1590480022768,\n    \"count\": 1\n  }\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3983,\n  \"method\": \"public/get_last_trades_by_instrument_and_time\",\n  \"params\": {\n    \"instrument_name\": \"ETH-PERPETUAL\",\n    \"end_timestamp\": 1590480022768,\n    \"count\": 1\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://test.deribit.com/api/v2/public/get_last_trades_by_instrument_and_time")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3983,\n  \"method\": \"public/get_last_trades_by_instrument_and_time\",\n  \"params\": {\n    \"instrument_name\": \"ETH-PERPETUAL\",\n    \"end_timestamp\": 1590480022768,\n    \"count\": 1\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "jsonrpc": "2.0",
  "id": 3983,
  "result": {
    "trades": [
      {
        "trade_seq": 1966031,
        "trade_id": "ETH-2696055",
        "timestamp": 1590479408216,
        "tick_direction": 0,
        "price": 203.6,
        "mark_price": 203.41,
        "instrument_name": "ETH-PERPETUAL",
        "index_price": 203.45,
        "direction": "buy",
        "amount": 10
      }
    ],
    "has_more": true
  }
}

Query Parameters

instrument_name

string

required

Instrument name Unique instrument identifier

Example:

"BTC-PERPETUAL"

start_timestamp

integer

Inclusive earliest timestamp (milliseconds since the Unix epoch). Time-based methods require at least one of start_timestamp or end_timestamp. The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

end_timestamp

integer

Inclusive latest timestamp (milliseconds since the Unix epoch). Time-based methods require at least one of start_timestamp or end_timestamp. The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

count

integer

Number of requested items, default - 10, maximum - 1000

Required range: 1 <= x <= 1000

sorting

enum<string>

Result ordering: asc, desc, or the method-specific default.

Available options:

asc,

desc,

default

Response

200 - application/json

Success response

jsonrpc

enum<string>

required

The JSON-RPC version (2.0)

Available options:

2.0

result

object

required

Hide child attributes

result.trades

object[]

required

Hide child attributes

result.trades.trade_id

string

required

Unique (per currency) trade identifier

result.trades.trade_seq

integer

required

The sequence number of the trade within instrument

result.trades.instrument_name

string

required

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result.trades.timestamp

integer

required

The timestamp of the trade (milliseconds since the UNIX epoch)

Example:

1517329113791

result.trades.direction

enum<string>

required

Trade direction of the taker

Available options:

buy,

sell

result.trades.tick_direction

enum<integer>

required

Direction of the "tick" (0 = Plus Tick, 1 = Zero-Plus Tick, 2 = Minus Tick, 3 = Zero-Minus Tick).

Available options:

0,

1,

2,

3

result.trades.index_price

number

required

Index Price at the moment of trade

result.trades.price

number

required

The price of the trade

result.trades.amount

number

required

Trade amount. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.

result.trades.mark_price

number | null

required

Mark Price at the moment of trade

result.trades.starbase_timestamp

integer

Optional field: the Starbase causal timestamp of the trade, in nanoseconds since the UNIX epoch (present only for trades matched in Starbase)

Example:

1536569522277000000

result.trades.contracts

number

Trade size in contract units (optional, may be absent in historical trades)

result.trades.iv

number

Option implied volatility for the price (Option only)

result.trades.liquidation

enum<string>

Optional field (only for trades caused by liquidation): "M" when maker side of trade was under liquidation, "T" when taker side was under liquidation, "MT" when both sides of trade were under liquidation

Available options:

M,

T,

MT

result.trades.block_trade_id

string

Block trade id - when trade was part of a block trade

Example:

"154"

result.trades.block_trade_leg_count

integer

Block trade leg count - when trade was part of a block trade

Example:

3

result.trades.combo_id

string

Optional field containing combo instrument name if the trade is a combo trade

result.trades.combo_trade_id

string

Optional field containing combo trade identifier if the trade is a combo trade

result.trades.starbase_match_id

integer

Optional field containing the Starbase match identifier (present only for trades matched via Starbase)

result.trades.block_rfq_id

integer

ID of the Block RFQ - when trade was part of the Block RFQ

result.trades.legs

array

Leg trades, present when querying only combo trades.

result.has_more

boolean

required

integer

The id that was sent in the request

Methods overview

Methods

public/get_last_trades_by_instrument_and_time

Query Parameters

Response