ProxyCove

Prices per GB (USD) for residential / mobile / datacenter proxies.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Countries available for the given proxy type.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "residential",
        "mobile",
        "datacenter"
      ],
      "description": "Proxy type"
    }
  },
  "required": [
    "type"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates a new account WITHOUT registration forms and returns an API key (pc_live_...). IMPORTANT: if the human already has a ProxyCove account, do NOT create a new one — ask them for a key from the website cabinet or the Telegram bot instead. The key is shown ONCE and IS the account: there is no password. Tell the human to save it and add it as the Authorization header ("Bearer <key>") of this connector. Losing the key means losing the balance unless a recovery channel is attached — offer attach_recovery (email) or link_telegram right after the account is created.

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "maxLength": 80,
      "description": "Short account label, e.g. the human's project name"
    },
    "contact_email": {
      "type": "string",
      "format": "email",
      "description": "Optional email for account recovery"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Current balance (USD), attached email and number of active proxies.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Creates an invoice and returns payment_url. Give the URL to the human — they open it in the browser and pay. Methods: sbp (Russian instant bank transfer, default for RU users), card_ru (Russian bank card), crypto (crypto via the RU provider), card_international (international card, best for non-RU users), crypto_cryptomus (crypto via Cryptomus — alternative crypto gateway). Agents must NEVER collect card details.

{
  "type": "object",
  "properties": {
    "amount_usd": {
      "type": "number",
      "minimum": 1.5,
      "maximum": 10000,
      "description": "Top-up amount in USD, min 1.5"
    },
    "method": {
      "type": "string",
      "enum": [
        "sbp",
        "card_ru",
        "crypto",
        "card_international",
        "crypto_cryptomus"
      ],
      "default": "sbp",
      "description": "Payment method"
    }
  },
  "required": [
    "amount_usd"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Tops up the ProxyCove balance by paying yourself, without sending a link to a human. Requires a machine payment credential (MPP / Shared Payment Token) in your HTTP client. Returns the endpoint and instructions: POST {"amount_usd": N} with your ProxyCove key in the Authorization header, answer the HTTP 402 challenge, and the balance is credited at once. If you have no payment credential, use create_topup instead and hand the link to the human.

{
  "type": "object",
  "properties": {
    "amount_usd": {
      "type": "number",
      "minimum": 1.5,
      "maximum": 10000,
      "description": "Amount in USD to add to the balance, min 1.5"
    }
  },
  "required": [
    "amount_usd"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Status of an invoice: pending | paid | cancelled. Poll after the human opens the payment link.

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Invoice id from create_topup"
    }
  },
  "required": [
    "invoice_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Buys a proxy, deducting the account balance. Returns connection credentials (host go.proxycove.com, port 824 = new IP every request, port 10000 = sticky IP by interval). Check get_pricing × traffic_gb against the balance first. IMPORTANT: wait ~5 seconds after the purchase before sending the first request through the proxy — the country filter takes a moment to propagate at the upstream provider, so an immediate first request may exit from another country.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "residential",
        "mobile",
        "datacenter"
      ],
      "description": "Proxy type"
    },
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Country code, e.g. \"br\" for Brazil. Omit for mixed pool"
    },
    "traffic_gb": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "description": "Prepaid traffic in GB"
    },
    "rotation_interval_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Sticky IP: keep the same IP for N minutes. Omit = rotate on every request"
    }
  },
  "required": [
    "type",
    "traffic_gb"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

All proxies of the account with remaining traffic and connection credentials.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Connection string for one proxy: http://login:[email protected]:port.

{
  "type": "object",
  "properties": {
    "proxy_id": {
      "type": "string",
      "description": "Proxy id from list_proxies"
    }
  },
  "required": [
    "proxy_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Adds prepaid GB to an existing proxy (same credentials keep working). Deducts balance.

{
  "type": "object",
  "properties": {
    "proxy_id": {
      "type": "string",
      "description": "Proxy id"
    },
    "traffic_gb": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "description": "GB to add"
    }
  },
  "required": [
    "proxy_id",
    "traffic_gb"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Live used / remaining traffic for one proxy.

{
  "type": "object",
  "properties": {
    "proxy_id": {
      "type": "string",
      "description": "Proxy id"
    }
  },
  "required": [
    "proxy_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Switch between rotate-every-request (port 824) and sticky interval 1..120 minutes (port 10000).

{
  "type": "object",
  "properties": {
    "proxy_id": {
      "type": "string",
      "description": "Proxy id"
    },
    "interval_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 120,
      "description": "Sticky interval; omit to rotate every request"
    }
  },
  "required": [
    "proxy_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns a short code the human sends to the ProxyCove Telegram bot (@ProxyCove_bot → "Link website account"). After linking, the human can manage the account and issue new API keys from the bot — a second way to keep access if the API key is lost. Code expires in 30 minutes.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Attaches an email to the account so the human can log in on proxycove.com (via "Forgot password") and never lose the balance.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "Human's email"
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}