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

GET /v2/stats/volume

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

GET /v2/stats/chart

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`);

Overview

Getting Started

Core Concepts

Swap Flow Guides

Widget Integration

Troubleshooting

Partner Operations

Partner Stats

Partner Stats

GET /v2/stats/volume

Endpoint

Parameters

Example Request

Example Response

Response Fields

GET /v2/stats/weeklyVolume

Endpoint

Parameters

Example Request

Example Response

Response Fields

GET /v2/stats/chart

Endpoint

Parameters

Example Request

Example Response

Response Fields

Code Example

​Partner Stats

​GET /v2/stats/volume

​Endpoint

​Parameters

​Example Request

​Example Response

​Response Fields

​GET /v2/stats/weeklyVolume

​Endpoint

​Parameters

​Example Request

​Example Response

​Response Fields

​GET /v2/stats/chart

​Endpoint

​Parameters

​Example Request

​Example Response

​Response Fields

​Code Example

Partner Stats

GET /v2/stats/volume

Endpoint

Parameters

Example Request

Example Response

Response Fields

GET /v2/stats/weeklyVolume

Endpoint

Parameters

Example Request

Example Response

Response Fields

GET /v2/stats/chart

Endpoint

Parameters

Example Request

Example Response

Response Fields

Code Example