Available

Analytics

get/v1/analytics/overview

GMV, trade volume, offer-acceptance match rate, and completion rate over a date range (default: trailing 30 days) for your own merchant — merchantId, if supplied, must match the caller.

curl -X GET https://api.tbbnetwork.com/v1/analytics/overview \
  -H "Authorization: Bearer sk_sandbox_..." \

Parameters

merchantId	query	optional
from	query	optional
to	query	optional

Response (200)

Field	Type	Required
range	object	—
merchantId	string,null (uuid)	—
gmv	number	—
tradeVolume	integer	—
completedTrades	integer	—
completionRate	number	—
offersCreated	integer	—
offersAccepted	integer	—
matchRate	number	—

Example 200 response

{
  "range": {
    "from": "2026-07-01T12:00:00Z",
    "to": "2026-07-01T12:00:00Z"
  },
  "merchantId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "gmv": 1,
  "tradeVolume": 1,
  "completedTrades": 1,
  "completionRate": 1,
  "offersCreated": 1,
  "offersAccepted": 1,
  "matchRate": 1
}