curl --request GET \
--url https://perps-api.vooi.io/bots/{id}/stats \
--header 'Authorization: Bearer <token>'import requests
url = "https://perps-api.vooi.io/bots/{id}/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://perps-api.vooi.io/bots/{id}/stats', 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://perps-api.vooi.io/bots/{id}/stats",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://perps-api.vooi.io/bots/{id}/stats"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://perps-api.vooi.io/bots/{id}/stats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://perps-api.vooi.io/bots/{id}/stats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"feesUsd": "<string>",
"fundingUsd": "<string>",
"netPnlUsd": "<string>",
"notionalHoursUsd": "<string>",
"notionalOpenedUsd": "<string>",
"realizedPnlUsd": "<string>",
"unrealizedPnlUsd": "<string>",
"volumeUsd": "<string>",
"abortedCycles": 4503599627370495,
"cycles": 4503599627370495,
"incompleteCycles": 4503599627370495,
"openCycles": 4503599627370495,
"partialCycles": 4503599627370495
}Read a bot's totals
Totals over every cycle this bot has recorded. Figures accrue to the close of each cycle, or to now while its pair is still held, and partial cycles are counted in incompleteCycles rather than dropped.
curl --request GET \
--url https://perps-api.vooi.io/bots/{id}/stats \
--header 'Authorization: Bearer <token>'import requests
url = "https://perps-api.vooi.io/bots/{id}/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://perps-api.vooi.io/bots/{id}/stats', 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://perps-api.vooi.io/bots/{id}/stats",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://perps-api.vooi.io/bots/{id}/stats"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://perps-api.vooi.io/bots/{id}/stats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://perps-api.vooi.io/bots/{id}/stats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"feesUsd": "<string>",
"fundingUsd": "<string>",
"netPnlUsd": "<string>",
"notionalHoursUsd": "<string>",
"notionalOpenedUsd": "<string>",
"realizedPnlUsd": "<string>",
"unrealizedPnlUsd": "<string>",
"volumeUsd": "<string>",
"abortedCycles": 4503599627370495,
"cycles": 4503599627370495,
"incompleteCycles": 4503599627370495,
"openCycles": 4503599627370495,
"partialCycles": 4503599627370495
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Bot identifier
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Response
Trading fees you paid on the cycle, stablecoin fees only.
Funding you received less funding you paid on both legs, from the entry until the cycle closed or, while it is open, until now; it can lag the venue by up to an hour.
Realized PnL less fees, plus funding, plus unrealized PnL while the cycle is open.
Entry notional multiplied by the hours the pair was held, counted to the close or, while the cycle is open, to now; it is zero until the entry fills.
What the entry filled, both legs together.
Realized PnL the venues reported on the cycle trades.
Unrealized PnL on the legs of an open cycle, and zero once the cycle closes.
Everything the cycle traded, entry and exit, both legs.
Cycles whose entry finished without filling, so no pair was ever held.
0 <= x <= 9007199254740991Cycles the bot has recorded.
0 <= x <= 9007199254740991Cycles whose figures are partial; every total here is a partial sum over the cycles, never null.
0 <= x <= 9007199254740991Cycles whose pair the bot is still working on.
0 <= x <= 9007199254740991Cycles whose figures stay partial: closed outside the bot, never confirmed, missing an order, paid in a non-stablecoin, or closed with a gap after the venues were synced. Cycles still syncing are counted in incompleteCycles only.
0 <= x <= 9007199254740991