curl --request GET \
--url https://api.sandbox.immutable.com/v1/chains/{chain_name}/tradesimport requests
url = "https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades', 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://api.sandbox.immutable.com/v1/chains/{chain_name}/trades",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"page": {
"previous_cursor": "MjAyMy0wMS0yM1QwMTo1NToyNy4zNTM2MzA",
"next_cursor": "MjAyMy0wMS0yM1QwMTo1NToyNy4zNTM2MzA"
},
"result": [
{
"buy": [
{
"type": "ERC20",
"amount": "9750000000000000000",
"contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
}
],
"buyer_address": "0xFC99a706C0D05B8C71E1fAAC91b3E1343aC34D40",
"buyer_fees": [],
"chain": {
"id": "eip155:11155111",
"name": "sepolia"
},
"created_at": "2022-03-07T07:20:50.52Z",
"id": "018792C9-4AD7-8EC4-4038-9E05C598534A",
"sell": [
{
"type": "ERC721",
"contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
"token_id": "1"
}
],
"seller_address": "0x002b9B1cbf464782Df5d48870358FA6c09f1b19D",
"maker_address": "0x002b9B1cbf464782Df5d48870358FA6c09f1b19D",
"taker_address": "0xFC99a706C0D05B8C71E1fAAC91b3E1343aC34D40",
"updated_at": "2022-03-07T07:20:50.52Z"
},
{
"buy": [
{
"type": "ERC20",
"amount": "9750000000000000000",
"contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
}
],
"buyer_address": "0x017406f3F27d507a1491976B7835CE5CD0fA647a",
"buyer_fees": [],
"chain": {
"id": "eip155:11155111",
"name": "sepolia"
},
"created_at": "2022-03-07T07:20:50.52Z",
"id": "018792C9-4AD7-8EC4-4038-9E05C598534A",
"sell": [
{
"type": "ERC721",
"contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
"token_id": "1"
}
],
"seller_address": "0xC73349c545C1D757eb650cDc463A2f6dF1Ec41cb",
"maker_address": "0xC73349c545C1D757eb650cDc463A2f6dF1Ec41cb",
"taker_address": "0x017406f3F27d507a1491976B7835CE5CD0fA647a",
"updated_at": "2022-03-07T07:20:50.52Z"
}
]
}{
"message": "all fields must be provided",
"link": "https://docs.x.immutable.com/reference/#/",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "VALIDATION_ERROR",
"details": {}
}{
"message": "all fields must be provided",
"link": "https://docs.x.immutable.com/reference/#/",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "RESOURCE_NOT_FOUND",
"details": {}
}{
"message": "all fields must be provided",
"link": "https://docs.x.immutable.com/reference/#/",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "INTERNAL_SERVER_ERROR",
"details": {}
}List all trades
List all trades
curl --request GET \
--url https://api.sandbox.immutable.com/v1/chains/{chain_name}/tradesimport requests
url = "https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades', 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://api.sandbox.immutable.com/v1/chains/{chain_name}/trades",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"page": {
"previous_cursor": "MjAyMy0wMS0yM1QwMTo1NToyNy4zNTM2MzA",
"next_cursor": "MjAyMy0wMS0yM1QwMTo1NToyNy4zNTM2MzA"
},
"result": [
{
"buy": [
{
"type": "ERC20",
"amount": "9750000000000000000",
"contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
}
],
"buyer_address": "0xFC99a706C0D05B8C71E1fAAC91b3E1343aC34D40",
"buyer_fees": [],
"chain": {
"id": "eip155:11155111",
"name": "sepolia"
},
"created_at": "2022-03-07T07:20:50.52Z",
"id": "018792C9-4AD7-8EC4-4038-9E05C598534A",
"sell": [
{
"type": "ERC721",
"contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
"token_id": "1"
}
],
"seller_address": "0x002b9B1cbf464782Df5d48870358FA6c09f1b19D",
"maker_address": "0x002b9B1cbf464782Df5d48870358FA6c09f1b19D",
"taker_address": "0xFC99a706C0D05B8C71E1fAAC91b3E1343aC34D40",
"updated_at": "2022-03-07T07:20:50.52Z"
},
{
"buy": [
{
"type": "ERC20",
"amount": "9750000000000000000",
"contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
}
],
"buyer_address": "0x017406f3F27d507a1491976B7835CE5CD0fA647a",
"buyer_fees": [],
"chain": {
"id": "eip155:11155111",
"name": "sepolia"
},
"created_at": "2022-03-07T07:20:50.52Z",
"id": "018792C9-4AD7-8EC4-4038-9E05C598534A",
"sell": [
{
"type": "ERC721",
"contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
"token_id": "1"
}
],
"seller_address": "0xC73349c545C1D757eb650cDc463A2f6dF1Ec41cb",
"maker_address": "0xC73349c545C1D757eb650cDc463A2f6dF1Ec41cb",
"taker_address": "0x017406f3F27d507a1491976B7835CE5CD0fA647a",
"updated_at": "2022-03-07T07:20:50.52Z"
}
]
}{
"message": "all fields must be provided",
"link": "https://docs.x.immutable.com/reference/#/",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "VALIDATION_ERROR",
"details": {}
}{
"message": "all fields must be provided",
"link": "https://docs.x.immutable.com/reference/#/",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "RESOURCE_NOT_FOUND",
"details": {}
}{
"message": "all fields must be provided",
"link": "https://docs.x.immutable.com/reference/#/",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "INTERNAL_SERVER_ERROR",
"details": {}
}Path Parameters
The name of chain
"imtbl-zkevm-testnet"
Query Parameters
Account address to filter trades by (includes buy and sell wallet address)
^0x[a-fA-F0-9]{40}$"0x784578949A4A50DeA641Fb15dd2B11C72E76919a"
Sell item contract address to filter by
^0x[a-fA-F0-9]{40}$"0x784578949A4A50DeA641Fb15dd2B11C72E76919a"
From indexed at including given date
"2022-03-09T05:00:50.52Z"
Maximum number of trades to return per page Maximum number of items to return
1 <= x <= 20010
Trade field to sort by
indexed_at "indexed_at"
Ascending or descending direction for sort
asc, desc "asc"
Page cursor to retrieve previous or next page. Use the value returned in the response. Encoded page cursor to retrieve previous or next page. Use the value returned in the response.
"ewogICJ0eXBlIjogInByZXYiLAogICJpdGVtIjogewogICAgImlkIjogNjI3NTEzMCwKICAgICJjcmVhdGVkX2F0IjogIjIwMjItMDktMTNUMTc6MDQ6MTIuMDI0MTI2WiIKICB9Cn0="
Was this page helpful?