API Reference / Proxy usage
List requests through your proxies
Lists your workspace's requests and connections through its proxies over a window of the last 6 hours at most, newest first: the time, the proxy endpoint, the account, the destination and path, the result, how long it took, the bytes each way and where the time went. Filtered by provider, pool, proxy, account, destination, kind and result, and searched by account, destination or path, before paging. A connection's byte counts are folded into its row. A request's path is recorded without its query string. No query, header or body is ever recorded. Rows show within about a minute.
/ analytics. v1. Analytics/ ListProxyRequestsRequest body
application/jsonRequired
Request for one page of the caller's workspace's requests and connections through its proxies over a window of the last 6 hours at most, filtered, searched and ordered by the service before paging.
cursor?stringnext_cursor from the previous page. Empty for the first page. Send the same filter and order with every page. A cursor used with different ones is rejected with invalid_argument.
descending?booleanTrue for newest first, the order the request log is shown in.
filter?ProxyRequestFilterThe window and which rows to list.
Show attributes
accountName?stringSteam account name, matched exactly.
destination?stringDestination, matched exactly: a host for a request (with its port only when it is not the usual one), a host and port or an address and port for a connection.
kind?stringRequests only or connections only. Absent covers both.
Value in"PROXY_"PROXY_
poolId?stringOpaque 16-byte identifier of a pool, base64-encoded in JSON.
Format"byte" base64
providerId?stringOpaque 16-byte identifier of a provider, base64-encoded in JSON.
Format"byte" base64
result?stringSucceeded only or failed only. Absent covers both.
Value in"PROXY_"PROXY_
search?stringText the account name, the destination or the path contains, ignoring case. Absent or empty matches every row.
sessionId?stringOpaque 16-byte identifier of one proxy (the proxies service's session), base64-encoded in JSON.
Format"byte" base64
startedBefore?stringExclusive end of the window. Absent means the time of the request. A list's later pages keep the end of its first page, so they never shift. Send the same explicit window to the list and the summary to have both count the same rows.
Format"date-time"
startedFrom?stringInclusive start of the window. Absent means 6 hours before started_before. A start more than 6 hours ago is rejected with invalid_argument: older rows are kept only to rebuild the rollup.
Format"date-time"
limit?integerRows per page, 1 to 500. Zero means 100. More than 500 is rejected with invalid_argument.
Format"int32"
sortField?stringThe order. Unspecified orders by start time.
Value in"PROXY_
Response body
application/json
Success
nextCursor?stringCursor for the next page. Empty on the last page.
requests?array<ProxyRequest>The page's rows in the requested order.
Show attributes
accountName?stringSteam account the request was made for.
bytesIn?stringResponse body bytes received, or every byte a connection received.
Format"int64"
bytesOut?stringRequest body bytes sent, or every byte a connection sent.
Format"int64"
connection?ProxyConnectionDetailFor a connection that opened: its state and how long it was open. Absent for a request, a failed dial and a connection recorded before 12 November 2026.
Show attributes
connectionId?stringOpaque 16-byte identifier of the connection, base64-encoded in JSON.
Format"byte" base64
lastReportedAt?stringWhen its latest event was sent: the close for a closed connection.
Format"date-time"
openFor?stringFrom the dial to last_reported_at: how long it has been open, or was open.
state?stringOpen, closed, or ended without a close reaching us.
Value in"PROXY_"PROXY_"PROXY_
destination?stringA request's host (with its port only when it is not the usual one), or a connection's host and port or address and port.
duration?stringThe whole request, to the end of its body, or the time a connection took to open.
errorClass?stringHow the request failed. Unspecified when it did not.
Value in"REQUEST_"REQUEST_"REQUEST_"REQUEST_"REQUEST_"REQUEST_"REQUEST_"REQUEST_"REQUEST_
id?stringIdentifier of the row, stable across reads.
kind?stringA request or a connection.
Value in"PROXY_"PROXY_
method?stringHTTP method of a request. Empty for a connection.
newConnection?booleanTrue when the request opened a new connection to the proxy rather than reusing one. Always true for a connection.
path?stringA request's path without its query string, cut to 512 bytes. The query is never recorded. Empty for a connection and for rows recorded before 17 November 2026.
poolId?stringOpaque 16-byte identifier of the pool, base64-encoded in JSON.
Format"byte" base64
providerId?stringOpaque 16-byte identifier of the provider, base64-encoded in JSON. A nil identifier for an imported pool.
Format"byte" base64
proxyEndpoint?stringThe proxy endpoint the dialler connected to, as host:port. For a fixed proxy this is its address. For a rotating provider's slot it is the provider's gateway and NOT the exit address the site saw, which is never recorded. The slot is the session's. Empty for rows recorded before 12 November 2026.
proxyScheme?stringThe proxy's scheme: "http", "https" or "socks5". Empty for rows recorded before 12 November 2026.
sessionId?stringOpaque 16-byte identifier of the proxy (the proxies service's session), base64-encoded in JSON.
Format"byte" base64
startedAt?stringWhen the request or the dial started.
Format"date-time"
statusCode?integerHTTP status of the answer, or of a proxy's refusal of a CONNECT. Zero when none arrived.
Format"int32"
timings?ProxyRequestTimingsWhere the time went. Absent for rows recorded before 12 November 2026.
Show attributes
connectionWait?stringWaiting for a connection, or for an idle one to be handed over. Our side.
download?stringDownloading the response, from its first byte to its end. The site.
firstByteWait?stringWaiting for the site's first byte. The site.
ours?stringOur side: connection_wait.
proxy?stringThe proxy: proxy_lookup, proxy_connect, proxy_sign_in and proxy_tunnel.
proxyConnect?stringConnecting to the proxy itself (its name looked up when given by name, and the TCP connect). The proxy.
proxyLookup?stringLooking up the proxy's own name, when it is given by name (a provider's gateway). Absent when the proxy is given by address. When present, proxy_connect is the TCP connect alone. The proxy.
proxySignIn?stringSigning in to a SOCKS5 proxy: the greeting and the username and password exchange. Absent for an HTTP CONNECT proxy, whose credentials travel with its connect request, and for rows recorded before 13 November 2026. When present, proxy_tunnel is the proxy reaching the site alone. The proxy.
proxyTunnel?stringThe proxy connecting to the site: the CONNECT or SOCKS5 handshake, which includes the proxy's own lookup of the site's name. The proxy.
requestWrite?stringSending the request. The site.
site?stringThe site: tls_handshake, request_write, first_byte_wait and download.
tlsHandshake?stringThe TLS handshake with the site through the proxy. The site.
unmeasured?stringThe rest of the whole duration that no phase covers (reading the response headers, scheduling). Absent when the phases cover it.
windowEnd?stringExclusive end of the window read, the same on every page.
Format"date-time"
windowStart?stringInclusive start of the window 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
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.
curl -X POST "https://api.goldmine.to/analytics.v1.Analytics/ListProxyRequests" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filter": {
"accountName": "karambit_kid",
"result": "PROXY_REQUEST_RESULT_FAILED"
},
"limit": 1,
"sortField": "PROXY_REQUEST_SORT_FIELD_STARTED_AT",
"descending": true
}'const res = await fetch("https://api.goldmine.to/analytics.v1.Analytics/ListProxyRequests", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"filter": {
"accountName": "karambit_kid",
"result": "PROXY_REQUEST_RESULT_FAILED"
},
"limit": 1,
"sortField": "PROXY_REQUEST_SORT_FIELD_STARTED_AT",
"descending": true
}),
});
const data = await res.json();body := strings.NewReader(`{
"filter": {
"accountName": "karambit_kid",
"result": "PROXY_REQUEST_RESULT_FAILED"
},
"limit": 1,
"sortField": "PROXY_REQUEST_SORT_FIELD_STARTED_AT",
"descending": true
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/analytics.v1.Analytics/ListProxyRequests", 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/analytics.v1.Analytics/ListProxyRequests",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"filter": {
"accountName": "karambit_kid",
"result": "PROXY_REQUEST_RESULT_FAILED"
},
"limit": 1,
"sortField": "PROXY_REQUEST_SORT_FIELD_STARTED_AT",
"descending": true
},
)
data = res.json(){
"requests": [
{
"id": "6f1c0e5a9b3d4c2e8a7f6b5c4d3e2f10",
"startedAt": "2026-11-12T18:41:31.204Z",
"kind": "PROXY_REQUEST_KIND_REQUEST",
"poolId": "AZrEoUhh/X+4C3EJAhYjqg==",
"sessionId": "AaHFRGk/esGOh46OJz2bzQ==",
"proxyEndpoint": "104.111.81.124:7796",
"proxyScheme": "socks5",
"accountName": "karambit_kid",
"method": "GET",
"destination": "steamcommunity.com",
"statusCode": 429,
"errorClass": "REQUEST_ERROR_CLASS_UPSTREAM_429",
"duration": "0.497s",
"bytesOut": "757",
"bytesIn": "25200",
"newConnection": true,
"timings": {
"connectionWait": "0.004s",
"proxyConnect": "0.043s",
"proxyTunnel": "0.058s",
"tlsHandshake": "0.059s",
"firstByteWait": "0.272s",
"download": "0.061s",
"ours": "0.004s",
"proxy": "0.101s",
"site": "0.392s"
}
}
],
"nextCursor": "eyJ2IjoxfQ",
"windowStart": "2026-11-12T12:42:00Z",
"windowEnd": "2026-11-12T18:42: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": "internal",
"message": "An internal server error occurred."
}