Get existing trades (unpaginated).
Deprecated: This endpoint is deprecated and will be removed in the future. Please use /api/v2/trades instead, which provides pagination support.
Exactly one of owner or orderUid must be set.
Results are sorted by block number and log index descending (newest trades first).
Note: This endpoint returns all matching trades without pagination. For paginated results, use /api/v2/trades.
Related docs:
curl --request GET \
--url https://api.cow.fi/mainnet/api/v1/tradesimport requests
url = "https://api.cow.fi/mainnet/api/v1/trades"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.cow.fi/mainnet/api/v1/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/v1/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/v1/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/v1/trades")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cow.fi/mainnet/api/v1/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"
Response
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/v1/tradesimport requests
url = "https://api.cow.fi/mainnet/api/v1/trades"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.cow.fi/mainnet/api/v1/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/v1/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/v1/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/v1/trades")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cow.fi/mainnet/api/v1/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"
}
]
}
]