Insights

Insights are per-product aggregates over an occurred-time window: distinct customers, event counts, fee-free money per currency, and a repeat rate. All money is the fee-free basis the producers stored, and merged customers are folded onto their survivor so a merged pair never double-counts. These endpoints take the global read scope; a read:own key is denied because insights are cross-source aggregates.

Dimensions

A dimension chooses which product axis to aggregate along and which event types are scanned for it. An unknown dimension returns 422.

Name
biller
Description
Bill-payment billers, scanned from billpay.completed. Money is the amount.
Name
loanProduct
Description
Loan products, scanned from loan.applied. Money is amountRequested.
Name
merchant
Description
Merchants, scanned from order.created and order.paid. Money is the order.paid subtotal.
Name
event
Description
Ticketed shows, scanned from ticket.purchased.
Name
mallProduct
Description
Mall products, scanned from the optional items array on order.created. Line money is price * quantity.

The mallProduct dimension only sees products from order.created events that carried an items array. Producers unlock it by sending line items; see Events.

GET/v1/insights/products

Product insights

GET /v1/insights/products returns the top products for a dimension by activity in the window.

Query params: dimension (required), windowDays (1..365, default 90), limit (1..100, default 25).

Each product carries key, name, customers (distinct), events, total (a per-currency money map), repeatCustomers, repeatRate, and lastActivityAt. The response also reports truncated: true when the window exceeded the internal scan cap.

Request

GET

/v1/insights/products

curl "https://c360-api.lioncapventures.com/v1/insights/products?dimension=merchant&windowDays=90&limit=25" \
  -H "X-API-Key: $C360_API_KEY"

Response (200)

{
  "success": true,
  "data": {
    "dimension": "merchant",
    "windowDays": 90,
    "truncated": false,
    "products": [
      {
        "key": "M1",
        "name": null,
        "customers": 128,
        "events": 342,
        "total": { "USD": "15230.00" },
        "repeatCustomers": 54,
        "repeatRate": 0.42,
        "lastActivityAt": "2026-08-10T08:59:00.000Z"
      }
    ],
    "generatedAt": "2026-08-10T09:20:00.000Z"
  }
}

GET/v1/insights/products/detail

Product detail

GET /v1/insights/products/detail is a deep-dive on one product key for a dimension: its metrics, its cross-product overlap (how many of its customers also order, pay bills, apply for loans, or buy tickets), its top customers, and its most-recent events.

Query params: dimension (required), key (required), windowDays (1..365, default 90). Returns 404 when no such product has activity in the window.

The overlap block reports alsoOrders, alsoBillpay, alsoLoans, and alsoTickets as counts of this product's customers who also have those event types.

Request

GET

/v1/insights/products/detail

curl "https://c360-api.lioncapventures.com/v1/insights/products/detail?dimension=merchant&key=M1&windowDays=90" \
  -H "X-API-Key: $C360_API_KEY"

Insights fold merged customers onto their survivor, so a customer counted here is always the surviving unified customer, never a merged duplicate.