Skip to content

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.

POST/analytics.v1.Analytics/ListProxyRequests

Request 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?string

next_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?boolean

True for newest first, the order the request log is shown in.

filter?ProxyRequestFilter

The window and which rows to list.

Show attributes
accountName?string

Steam account name, matched exactly.

destination?string

Destination, 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?string

Requests only or connections only. Absent covers both.

Value in"PROXY_REQUEST_KIND_REQUEST""PROXY_REQUEST_KIND_CONNECTION"

poolId?string

Opaque 16-byte identifier of a pool, base64-encoded in JSON.

Format"byte" base64

providerId?string

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

Format"byte" base64

result?string

Succeeded only or failed only. Absent covers both.

Value in"PROXY_REQUEST_RESULT_SUCCEEDED""PROXY_REQUEST_RESULT_FAILED"

search?string

Text the account name, the destination or the path contains, ignoring case. Absent or empty matches every row.

sessionId?string

Opaque 16-byte identifier of one proxy (the proxies service's session), base64-encoded in JSON.

Format"byte" base64

startedBefore?string

Exclusive 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?string

Inclusive 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?integer

Rows per page, 1 to 500. Zero means 100. More than 500 is rejected with invalid_argument.

Format"int32"

sortField?string

The order. Unspecified orders by start time.

Value in"PROXY_REQUEST_SORT_FIELD_STARTED_AT"

Response body

application/json

Success

nextCursor?string

Cursor for the next page. Empty on the last page.

requests?array<ProxyRequest>

The page's rows in the requested order.

Show attributes
accountName?string

Steam account the request was made for.

bytesIn?string

Response body bytes received, or every byte a connection received.

Format"int64"

bytesOut?string

Request body bytes sent, or every byte a connection sent.

Format"int64"

connection?ProxyConnectionDetail

For 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?string

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

Format"byte" base64

lastReportedAt?string

When its latest event was sent: the close for a closed connection.

Format"date-time"

openFor?string

From the dial to last_reported_at: how long it has been open, or was open.

state?string

Open, closed, or ended without a close reaching us.

Value in"PROXY_CONNECTION_STATE_OPEN""PROXY_CONNECTION_STATE_CLOSED""PROXY_CONNECTION_STATE_ENDED_UNREPORTED"

destination?string

A 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?string

The whole request, to the end of its body, or the time a connection took to open.

errorClass?string

How the request failed. Unspecified when it did not.

Value in"REQUEST_ERROR_CLASS_DIAL_TIMEOUT""REQUEST_ERROR_CLASS_DIAL_REFUSED""REQUEST_ERROR_CLASS_AUTH_FAILED""REQUEST_ERROR_CLASS_TLS_HANDSHAKE""REQUEST_ERROR_CLASS_ROUNDTRIP_TIMEOUT""REQUEST_ERROR_CLASS_UPSTREAM_5XX""REQUEST_ERROR_CLASS_UPSTREAM_429""REQUEST_ERROR_CLASS_BODY_READ""REQUEST_ERROR_CLASS_CLIENT_CANCELLED"

id?string

Identifier of the row, stable across reads.

kind?string

A request or a connection.

Value in"PROXY_REQUEST_KIND_REQUEST""PROXY_REQUEST_KIND_CONNECTION"

method?string

HTTP method of a request. Empty for a connection.

newConnection?boolean

True when the request opened a new connection to the proxy rather than reusing one. Always true for a connection.

path?string

A 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?string

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

Format"byte" base64

providerId?string

Opaque 16-byte identifier of the provider, base64-encoded in JSON. A nil identifier for an imported pool.

Format"byte" base64

proxyEndpoint?string

The 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?string

The proxy's scheme: "http", "https" or "socks5". Empty for rows recorded before 12 November 2026.

sessionId?string

Opaque 16-byte identifier of the proxy (the proxies service's session), base64-encoded in JSON.

Format"byte" base64

startedAt?string

When the request or the dial started.

Format"date-time"

statusCode?integer

HTTP status of the answer, or of a proxy's refusal of a CONNECT. Zero when none arrived.

Format"int32"

timings?ProxyRequestTimings

Where the time went. Absent for rows recorded before 12 November 2026.

Show attributes
connectionWait?string

Waiting for a connection, or for an idle one to be handed over. Our side.

download?string

Downloading the response, from its first byte to its end. The site.

firstByteWait?string

Waiting for the site's first byte. The site.

ours?string

Our side: connection_wait.

proxy?string

The proxy: proxy_lookup, proxy_connect, proxy_sign_in and proxy_tunnel.

proxyConnect?string

Connecting to the proxy itself (its name looked up when given by name, and the TCP connect). The proxy.

proxyLookup?string

Looking 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?string

Signing 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?string

The 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?string

Sending the request. The site.

site?string

The site: tls_handshake, request_write, first_byte_wait and download.

tlsHandshake?string

The TLS handshake with the site through the proxy. The site.

unmeasured?string

The rest of the whole duration that no phase covers (reading the response headers, scheduling). Absent when the phases cover it.

windowEnd?string

Exclusive end of the window read, the same on every page.

Format"date-time"

windowStart?string

Inclusive start of the window read.

Format"date-time"

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
  }'
{
  "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"
}