Skip to content

API Reference / Proxy sessions

Replace a failing proxy address at its provider

Asks the pool's provider for a fresh address in place of one fixed address that is failing its checks or that the provider stopped listing. The replacement is quoted first and made only when the provider charges nothing. A quote above zero is refused with the amount. One replacement is made per session, so sending the call again returns the first one. Accounts on the old address stay on it: the new address joins the pool on the next read of the provider's proxy list, and RebindAssignment or UpdateAssignment then moves an account onto it. Offered for Suborbital static pools.

POST/proxies.v1.Proxies/ReplaceSessionAddress

Request body

application/jsonRequired

Request to ask the pool's provider for a fresh address in place of one failing fixed address, at no charge.

sessionId?string

Opaque 16-byte identifier of the session whose address to replace, base64-encoded in JSON.

Format"byte" base64

Response body

application/json

Success

replacement?ProxiesSessionAddressReplacement

The replacement made for the session, or the one made by an earlier call.

Show attributes
chargedCostCents?string

What the provider's balance fell by across the replacement, in US cents. Absent until the replacement is confirmed, or when the provider reports no balance.

Format"int64"

id?string

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

Format"byte" base64

newAddress?string

The address the provider gave in its place. Absent until the provider confirmed the replacement, and absent when its answer was lost and a later call found the old address already gone from the account. The new address then joins the pool through the provider's list as usual.

poolId?string

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

Format"byte" base64

previousAddress?string

The address given up, as the provider names it.

providerId?string

Opaque 16-byte identifier of the provider asked for the new address, base64-encoded in JSON.

Format"byte" base64

quotedCostCents?string

What the provider quoted for the replacement before it was made, in US cents. Always zero: the call goes ahead only at no charge.

Format"int64"

replacedAt?string

When the provider confirmed the replacement. Absent until then.

Format"date-time"

requestedAt?string

When the replacement was asked for.

Format"date-time"

requestedBy?string

Opaque 16-byte identifier of the person or API key that asked, base64-encoded in JSON.

Format"byte" base64

sessionId?string

Opaque 16-byte identifier of the session whose address was replaced, base64-encoded in JSON.

Format"byte" base64

status?string

Whether the provider has confirmed the replacement.

Value in"SESSION_ADDRESS_REPLACEMENT_STATUS_REQUESTED""SESSION_ADDRESS_REPLACEMENT_STATUS_REPLACED"

workspaceId?string

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

Format"byte" base64

curl -X POST "https://api.goldmine.to/proxies.v1.Proxies/ReplaceSessionAddress" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "AY+MIjMzfu6P/05OTk5OTg=="
  }'
{
  "replacement": {
    "id": "AY+MI2ZmfO6P/05OTk5OTg==",
    "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
    "sessionId": "AY+MIjMzfu6P/05OTk5OTg==",
    "poolId": "AY+MISIifMyN3T09PT09PQ==",
    "providerId": "AY+MIBEReqqLuywsLCwsLA==",
    "previousAddress": "203.0.113.23",
    "newAddress": "198.51.100.183",
    "status": "SESSION_ADDRESS_REPLACEMENT_STATUS_REPLACED",
    "quotedCostCents": "0",
    "chargedCostCents": "0",
    "requestedBy": "AY+MHnorfD2eTxorPE1ebw==",
    "requestedAt": "2026-11-15T10:07:42Z",
    "replacedAt": "2026-11-15T10:07:44Z"
  }
}