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.
/ proxies. v1. Proxies/ GetProviderPurchaseTotalRequest 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?stringOpaque 16-byte identifier of the provider connection, base64-encoded in JSON.
Format"byte" base64
Response body
application/json
Success
purchaseTotal?ProxiesProviderPurchaseTotalThe purchases total for the last 30 days.
Show attributes
providerId?stringOpaque 16-byte identifier of the provider connection, base64-encoded in JSON.
Format"byte" base64
purchaseBudgetCents?stringThe provider's purchase budget for any rolling 30 days, in US cents. Absent when buying is switched off.
Format"int64"
purchaseCount?integerHow many proxies were bought from this provider in the last 30 days.
Format"int32"
purchasedCents?stringTotal cost of the proxies bought from this provider in the last 30 days, in US cents.
Format"int64"
windowStart?stringThe start of the 30 day window the total covers. The window ends at the time of the read.
Format"date-time"
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The requested resource does not exist in this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The service is temporarily unavailable. Retry with backoff.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
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=="
}'const res = await fetch("https://api.goldmine.to/proxies.v1.Proxies/GetProviderPurchaseTotal", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"providerId": "AY+MIZmZfu6P/05OTk5OTg=="
}),
});
const data = await res.json();body := strings.NewReader(`{
"providerId": "AY+MIZmZfu6P/05OTk5OTg=="
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/proxies.v1.Proxies/GetProviderPurchaseTotal", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/proxies.v1.Proxies/GetProviderPurchaseTotal",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"providerId": "AY+MIZmZfu6P/05OTk5OTg=="
},
)
data = res.json(){
"purchaseTotal": {
"providerId": "AY+MIZmZfu6P/05OTk5OTg==",
"purchaseBudgetCents": "15000",
"purchasedCents": "354",
"purchaseCount": 2,
"windowStart": "2026-10-11T09:00:00Z"
}
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "not_found",
"message": "The requested resource does not exist in this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}{
"code": "unavailable",
"message": "The service is temporarily unavailable. Retry with backoff."
}