curl --request GET \
--url https://nexus.gerowallet.io/api/partner/swaps/summary \
--header 'X-Api-Key: <api-key>'import requests
url = "https://nexus.gerowallet.io/api/partner/swaps/summary"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://nexus.gerowallet.io/api/partner/swaps/summary', 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://nexus.gerowallet.io/api/partner/swaps/summary",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$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://nexus.gerowallet.io/api/partner/swaps/summary"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://nexus.gerowallet.io/api/partner/swaps/summary")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.gerowallet.io/api/partner/swaps/summary")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"asOf": "2023-11-07T05:31:56Z",
"last24h": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last7d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last30d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
}
}{
"asOf": "2023-11-07T05:31:56Z",
"last24h": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last7d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last30d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
}
}{
"asOf": "2023-11-07T05:31:56Z",
"last24h": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last7d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last30d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
}
}{
"asOf": "2023-11-07T05:31:56Z",
"last24h": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last7d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last30d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
}
}Your swap counter
How many swaps were built, submitted and confirmed through the key that authenticates this call in the last 24 hours, 7 days and 30 days, and the ADA volume that moved. Counts only: no amount per swap, no transaction hash, no wallet, no fee, share or revenue figure. That is why, unlike every other /api/partner endpoint, this one also answers to a PUBLIC partner key from a registered origin, so a live counter can run in your page with the same key the widget uses.
Called with an API key (public partner or ordinary), the figures are that key’s alone. Called over a Nexus dashboard session, they cover all of your personal keys.
Windows nest and are bucketed by build time: 24h is a rolling window ending now; 7d and 30d are whole UTC calendar days ending today, so 7d spans between six and seven days. submitted means a transaction hash exists, whatever happened afterwards. volumeOrders below confirmed means the ADA volume covers only that fraction of the swaps, because the engine did not record an ADA notional on the rest.
Poll every 15 seconds at most; the response is cacheable for that long and the server answers from the same reading inside it.
curl --request GET \
--url https://nexus.gerowallet.io/api/partner/swaps/summary \
--header 'X-Api-Key: <api-key>'import requests
url = "https://nexus.gerowallet.io/api/partner/swaps/summary"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://nexus.gerowallet.io/api/partner/swaps/summary', 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://nexus.gerowallet.io/api/partner/swaps/summary",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$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://nexus.gerowallet.io/api/partner/swaps/summary"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://nexus.gerowallet.io/api/partner/swaps/summary")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.gerowallet.io/api/partner/swaps/summary")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"asOf": "2023-11-07T05:31:56Z",
"last24h": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last7d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last30d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
}
}{
"asOf": "2023-11-07T05:31:56Z",
"last24h": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last7d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last30d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
}
}{
"asOf": "2023-11-07T05:31:56Z",
"last24h": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last7d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last30d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
}
}{
"asOf": "2023-11-07T05:31:56Z",
"last24h": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last7d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
},
"last30d": {
"window": "24h",
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"builds": 42,
"submitted": 37,
"confirmed": 35,
"volumeAda": 12500.5,
"volumeOrders": 35
}
}Authorizations
API key (programmatic access — recommended)
Send your API key in the X-Api-Key header. Keys start with nxs_ and are
created in the dashboard (or via POST /api/keys with a session JWT).
Each key is scoped to one chain and one network (for example
CARDANO_MAINNET), fixed at creation time. It cannot query a different network
on the same chain, and it cannot query a different chain at all. A mismatched
network parameter returns 400 Network Mismatch. Create one key per chain
and network under the same account.
This is the credential most integrations should use.
Response
The counter for the authenticated key
Swap counts and ADA volume for the authenticated key over the last 24 hours, 7 days and 30 days.
When the figures were computed. Every window ends here.
Swap counts and ADA volume over one window, bucketed by build time.
Show child attributes
Show child attributes
Swap counts and ADA volume over one window, bucketed by build time.
Show child attributes
Show child attributes
Swap counts and ADA volume over one window, bucketed by build time.
Show child attributes
Show child attributes