Skip to content

API Reference / Proxy providers

Get a proxy provider's purchases total

Returns what the service has spent buying new proxies from a connected provider over the last 30 days, with the purchase budget it counts against. Renewals are not included.

POST/proxies.v1.Proxies/GetProviderPurchaseTotal

Request body

application/jsonRequired

Request for what the service has spent buying new proxies from one provider in the caller's workspace over the last 30 days.

providerId?string

Opaque 16-byte identifier of the provider connection, base64-encoded in JSON.

Format"byte" base64

Response body

application/json

Success

purchaseTotal?ProxiesProviderPurchaseTotal

The purchases total for the last 30 days.

Show attributes
providerId?string

Opaque 16-byte identifier of the provider connection, base64-encoded in JSON.

Format"byte" base64

purchaseBudgetCents?string

The provider's purchase budget for any rolling 30 days, in US cents. Absent when buying is switched off.

Format"int64"

purchaseCount?integer

How many proxies were bought from this provider in the last 30 days.

Format"int32"

purchasedCents?string

Total cost of the proxies bought from this provider in the last 30 days, in US cents.

Format"int64"

windowStart?string

The start of the 30 day window the total covers. The window ends at the time of the read.

Format"date-time"

curl -X POST "https://api.goldmine.to/proxies.v1.Proxies/GetProviderPurchaseTotal" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "providerId": "AY+MIZmZfu6P/05OTk5OTg=="
  }'
{
  "purchaseTotal": {
    "providerId": "AY+MIZmZfu6P/05OTk5OTg==",
    "purchaseBudgetCents": "15000",
    "purchasedCents": "354",
    "purchaseCount": 2,
    "windowStart": "2026-10-11T09:00:00Z"
  }
}