Get existing trades (paginated).
Exactly one of owner or orderUid must be set.
Results are paginated and sorted by block number and log index descending (newest trades first).
To enumerate all trades start with offset 0 and keep increasing the
offset by the total number of returned results. When a response
contains less than limit the last page has been reached.
Related docs:
curl --request GET \
--url https://api.cow.fi/mainnet/api/v2/tradesimport requests
url = "https://api.cow.fi/mainnet/api/v2/trades"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.cow.fi/mainnet/api/v2/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.cow.fi/mainnet/api/v2/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.cow.fi/mainnet/api/v2/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.cow.fi/mainnet/api/v2/trades")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cow.fi/mainnet/api/v2/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[
{
"blockNumber": 123,
"logIndex": 123,
"orderUid": "0xff2e2e54d178997f173266817c1e9ed6fee1a1aae4b43971c53b543cffcc2969845c6f5599fbb25dbdd1b9b013daf85c03f3c63763e4bc4a",
"owner": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"sellToken": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"buyToken": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"sellAmount": "1234567890",
"sellAmountBeforeFees": "1234567890",
"buyAmount": "1234567890",
"txHash": "0xd51f28edffcaaa76be4a22f6375ad289272c037f3cc072345676e88d92ced8b5",
"executedProtocolFees": [
{
"policy": {
"factor": 0.5,
"maxVolumeFactor": 0.5
},
"amount": "1234567890",
"token": "0x6810e776880c02933d47db1b9fc05908e5386b96"
}
]
}
]Query Parameters
20 byte Ethereum address encoded as a hex with 0x prefix.
"0x6810e776880c02933d47db1b9fc05908e5386b96"
Unique identifier for the order: 56 bytes encoded as hex with 0x
prefix.
Bytes 0..32 are the order digest, bytes 30..52 the owner address and
bytes 52..56 the expiry (validTo) as a uint32 unix epoch timestamp.
"0xff2e2e54d178997f173266817c1e9ed6fee1a1aae4b43971c53b543cffcc2969845c6f5599fbb25dbdd1b9b013daf85c03f3c63763e4bc4a"
The pagination offset. Defaults to 0.
The maximum number of trades to return. Defaults to 10. Must be between 1 and 1000.
1 <= x <= 1000Response
If owner is specified:
Return all trades related to that owner.
If orderUid is specified:
Return all trades related to that orderUid. Given that an order
may be partially fillable, it is possible that an individual order
may have multiple trades.
Block in which trade occurred.
Index in which transaction was included in block.
UID of the order matched by this trade.
"0xff2e2e54d178997f173266817c1e9ed6fee1a1aae4b43971c53b543cffcc2969845c6f5599fbb25dbdd1b9b013daf85c03f3c63763e4bc4a"
Address of trader.
"0x6810e776880c02933d47db1b9fc05908e5386b96"
Address of token sold.
"0x6810e776880c02933d47db1b9fc05908e5386b96"
Address of token bought.
"0x6810e776880c02933d47db1b9fc05908e5386b96"
Total amount of sellToken that has been executed for this trade (including fees).
"1234567890"
The total amount of sellToken that has been executed for this order without fees.
"1234567890"
Total amount of buyToken received in this trade.
"1234567890"
Transaction hash of the corresponding settlement transaction containing the trade (if available).
"0xd51f28edffcaaa76be4a22f6375ad289272c037f3cc072345676e88d92ced8b5"
Executed protocol fees for this trade, together with the fee policies used. Listed in the order they got applied.
Show child attributes
Show child attributes
Was this page helpful?
curl --request GET \
--url https://api.cow.fi/mainnet/api/v2/tradesimport requests
url = "https://api.cow.fi/mainnet/api/v2/trades"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.cow.fi/mainnet/api/v2/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.cow.fi/mainnet/api/v2/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.cow.fi/mainnet/api/v2/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.cow.fi/mainnet/api/v2/trades")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cow.fi/mainnet/api/v2/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[
{
"blockNumber": 123,
"logIndex": 123,
"orderUid": "0xff2e2e54d178997f173266817c1e9ed6fee1a1aae4b43971c53b543cffcc2969845c6f5599fbb25dbdd1b9b013daf85c03f3c63763e4bc4a",
"owner": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"sellToken": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"buyToken": "0x6810e776880c02933d47db1b9fc05908e5386b96",
"sellAmount": "1234567890",
"sellAmountBeforeFees": "1234567890",
"buyAmount": "1234567890",
"txHash": "0xd51f28edffcaaa76be4a22f6375ad289272c037f3cc072345676e88d92ced8b5",
"executedProtocolFees": [
{
"policy": {
"factor": 0.5,
"maxVolumeFactor": 0.5
},
"amount": "1234567890",
"token": "0x6810e776880c02933d47db1b9fc05908e5386b96"
}
]
}
]