Partner Stats
The stats endpoints return metrics scoped to your partner account — not platform-wide totals. Use them to build dashboards, monitor performance, or integrate your volume data into internal reporting.
All stats endpoints require full API key authentication (Authorization: <partnerId>:<apiSecret>). The public partner-id header does not grant access.
GET /v2/stats/volume
Returns cumulative volume metrics for your partner account.
Endpoint
Parameters
None.
Example Request
curl -X GET "https://api-partner.houdiniswap.com/v2/stats/volume" \
-H "Authorization: <partnerId>:<apiSecret>"
Example Response
{
"count": 1284,
"totalTransactedUSD": 4821903.55,
"totalOrders": 1284,
"thisMonthVolumeUsd": 312450.20,
"lastMonthVolumeUsd": 498201.75,
"thisMonthOrders": 215
}
Response Fields
| Field | Type | Description |
|---|
count | number | Total completed transactions (all time) |
totalTransactedUSD | number | Total transacted value in USD (all time) |
totalOrders | number | Alias for count |
thisMonthVolumeUsd | number | Transacted value in USD for the current calendar month |
lastMonthVolumeUsd | number | Transacted value in USD for the previous calendar month |
thisMonthOrders | number | Completed transactions in the current calendar month |
GET /v2/stats/weeklyVolume
Returns a per-week breakdown of your partner volume, ordered chronologically.
Endpoint
GET /v2/stats/weeklyVolume
Parameters
None.
Example Request
curl -X GET "https://api-partner.houdiniswap.com/v2/stats/weeklyVolume" \
-H "Authorization: <partnerId>:<apiSecret>"
Example Response
[
{
"week": 15,
"year": 2026,
"count": 87,
"anonymous": 34,
"volume": 41250.00,
"commission": 103.13
},
{
"week": 16,
"year": 2026,
"count": 112,
"anonymous": 45,
"volume": 58930.50,
"commission": 147.33
}
]
Response Fields
| Field | Type | Description |
|---|
week | number | ISO week number (1–53) |
year | number | Year |
count | number | Total transactions for the week |
anonymous | number | Number of private (anonymous) transactions |
volume | number | Total transaction volume in USD |
commission | number | Commission earned in USD for the week |
GET /v2/stats/chart
Returns time-series data for a given metric over a custom date range. Useful for building volume charts in dashboards or analytics tools.
Endpoint
Parameters
| Field | Type | Required | Description |
|---|
metric | string | Yes | Metric to chart. Currently supported: volume |
from | string | Yes | Start of range (ISO 8601, e.g. 2026-01-01T00:00:00Z) |
to | string | Yes | End of range (ISO 8601, e.g. 2026-04-22T23:59:59Z) |
granularity | string | No | Bucket size: day (default) or month |
Example Request
curl -X GET "https://api-partner.houdiniswap.com/v2/stats/chart?metric=volume&from=2026-03-23T00:00:00Z&to=2026-04-22T23:59:59Z&granularity=day" \
-H "Authorization: <partnerId>:<apiSecret>"
Example Response
[
{ "date": "2026-03-23", "volumeUsd": 12430.50, "count": 28 },
{ "date": "2026-03-24", "volumeUsd": 9870.00, "count": 21 },
{ "date": "2026-03-25", "volumeUsd": 15210.75, "count": 35 }
]
Response Fields
| Field | Type | Description |
|---|
date | string | Bucket date. Format: YYYY-MM-DD for day, YYYY-MM for month |
volumeUsd | number | Total transacted value in USD for the bucket |
count | number | Number of completed transactions in the bucket |
Days or months with no activity are omitted from the response. Your charting code should fill in zero values for missing dates.
Code Example
Fetch all three stats endpoints and log a summary:
const BASE = "https://api-partner.houdiniswap.com/v2";
const AUTH = `${process.env.PARTNER_ID}:${process.env.API_SECRET}`;
const headers = { Authorization: AUTH };
// Volume summary
const volumeRes = await fetch(`${BASE}/stats/volume`, { headers });
const volume = await volumeRes.json();
console.log(`All-time: ${volume.count} orders / $${volume.totalTransactedUSD.toFixed(2)}`);
console.log(`This month: ${volume.thisMonthOrders} orders / $${volume.thisMonthVolumeUsd.toFixed(2)}`);
// Last 30 days chart (daily granularity)
const to = new Date().toISOString();
const from = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString();
const chartRes = await fetch(
`${BASE}/stats/chart?metric=volume&from=${from}&to=${to}&granularity=day`,
{ headers }
);
const chart = await chartRes.json();
console.log(`Chart data points: ${chart.length}`);
// Weekly breakdown
const weeklyRes = await fetch(`${BASE}/stats/weeklyVolume`, { headers });
const weekly = await weeklyRes.json();
const latestWeek = weekly[weekly.length - 1];
console.log(`Week ${latestWeek.week}/${latestWeek.year}: $${latestWeek.volume} volume, $${latestWeek.commission} commission`);
