API Reference / Proxy sessions
List proxies no longer provided
Returns the proxies in your workspace that their provider no longer provides, newest first by default: each with its address, when it stopped, the last account that used it and where that account is now. A proxy the provider stopped listing, or one the provider reports ended that fails its checks, is listed here once no account is on it, and is no longer counted, listed or checked as one of its pool's proxies. Results are paginated. Pass an empty cursor for the first page and follow the returned cursor for subsequent pages.
/ proxies. v1. Proxies/ ListEndedSessionsRequest body
application/jsonRequired
Request for one page of the proxies in the caller's workspace that their provider no longer provides.
cursor?stringOpaque pagination cursor from a previous ListEndedSessionsResponse. Empty for the first page.
descending?booleanOrder descending instead of ascending. The provider page shows the newest first.
filter?EndedSessionFilterOptional filters applied before pagination.
Show attributes
poolId?stringOptional pool id to limit results to one pool.
Format"byte" base64
providerId?stringOptional provider id to limit results to one provider's proxies.
Format"byte" base64
limit?integerMaximum number of proxies to return. Server caps this at a service-defined upper bound.
Format"int32"
sortField?stringField to order the page by. Unspecified orders by when the proxy stopped being provided.
Value in"ENDED_
Response body
application/json
Success
nextCursor?stringCursor to pass to fetch the next page. Empty when there are no more results.
sessions?array<EndedSession>The proxies for this page, ordered by the requested sort.
Show attributes
endedAt?stringWhen it stopped being provided: the end the provider reports for it when it gives one, otherwise when the provider was first seen no longer listing it.
Format"date-time"
host?stringThe proxy's host.
lastAccountName?stringThe last account that sent traffic through it, from the usage record. Empty when no account ever used it.
lastAccountNow?EndedSessionAccountPlacementThe proxy that account is on now. Absent when the account has no proxy or no account ever used this one.
Show attributes
host?stringThe host of that proxy.
port?integerThe port of that proxy.
Format"int32"
sessionId?stringOpaque 16-byte identifier of the session the account is on now, base64-encoded in JSON.
Format"byte" base64
poolId?stringOpaque 16-byte identifier of the pool it was in, base64-encoded in JSON.
Format"byte" base64
port?integerThe proxy's port.
Format"int32"
providerId?stringOpaque 16-byte identifier of its provider, base64-encoded in JSON. Empty for an imported proxy.
Format"byte" base64
sessionId?stringOpaque 16-byte identifier of the session, base64-encoded in JSON.
Format"byte" base64
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 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/ListEndedSessions" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"limit": 50,
"filter": {
"providerId": "AY+MIBEReqqLuywsLCwsLA=="
}
}'const res = await fetch("https://api.goldmine.to/proxies.v1.Proxies/ListEndedSessions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"limit": 50,
"filter": {
"providerId": "AY+MIBEReqqLuywsLCwsLA=="
}
}),
});
const data = await res.json();body := strings.NewReader(`{
"limit": 50,
"filter": {
"providerId": "AY+MIBEReqqLuywsLCwsLA=="
}
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/proxies.v1.Proxies/ListEndedSessions", 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/ListEndedSessions",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"limit": 50,
"filter": {
"providerId": "AY+MIBEReqqLuywsLCwsLA=="
}
},
)
data = res.json(){
"sessions": [
{
"sessionId": "AY+MIjMzfu6P/05OTk5OTg==",
"poolId": "AY+MISIifMyN3T09PT09PQ==",
"providerId": "AY+MIBEReqqLuywsLCwsLA==",
"host": "203.0.113.10",
"port": 62903,
"endedAt": "2026-11-11T13:14:08Z",
"lastAccountName": "trader-1",
"lastAccountNow": {
"sessionId": "AY+MJTQ0NDQ0NDQ0NDQ0NA==",
"host": "203.0.113.24",
"port": 62711
}
}
],
"nextCursor": ""
}{
"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": "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."
}