API reference

GateProxy API documentation

Use the GateProxy API to build a reseller website, Telegram bot, panel, or internal proxy automation system. The API supports provider discovery, pricing, balance checks, proxy orders, order history, and traffic usage checks.

Start integration Download collection

6Providers

7Core endpoints

BearerToken auth

JSONResponse format

Getting started

Quick start

Generate an API token from the Telegram bot using the API Token menu.
Check your balance before creating an order.
Load pricing dynamically from the pricing endpoint.
Create an order with provider and plan.
Save the order ID for later status and usage checks.

GET/account/balance

Start by confirming that the authenticated account has enough balance.

curl -H "Authorization: Bearer gpk_live_xxxxxxxxx" \
https://api.gateproxy.store/account/balance

Security

Authentication

Every protected endpoint requires an API token. Use the Authorization header for production integrations.

Recommended header

Authorization: Bearer gpk_live_xxxxxxxxx

Do not expose tokens

Keep the API token in your backend environment. Never put it in public frontend JavaScript.

Alternative methods

Method	Example	Recommended
Bearer header	`Authorization: Bearer token`	Yes
API token header	`X-API-Token: token`	OK for simple clients
Query parameter	`?api_token=token`	Testing only

Catalog

Get providers

GET/providers

Returns all active proxy providers configured in the bot.

curl -H "Authorization: Bearer gpk_live_xxxxxxxxx" \
https://api.gateproxy.store/providers

Success response

{
  "success": true,
  "providers": [
    { "id": "abcproxy", "name": "ABC Proxy", "status": "active" },
    { "id": "9proxy", "name": "9Proxy", "status": "active" },
    { "id": "nodemaven", "name": "NodeMaven", "status": "active" }
  ]
}

Provider IDs

Name	Provider ID	Usage check
ABC Proxy	`abcproxy`	Supported
9Proxy	`9proxy`	Supported
ProxySeller	`proxyseller`	Telegram checker bot
NodeMaven	`nodemaven`	Supported
DataImpulse	`dataimpulse`	Supported
9Proxy CD Key	`9proxy_cd_key`	Not available

Plans

Pricing endpoints

GET/providers/{provider_id}/pricing

Returns one provider's plan list. Use the returned plan value when creating orders.

curl -H "Authorization: Bearer gpk_live_xxxxxxxxx" \
https://api.gateproxy.store/providers/nodemaven/pricing

{
  "success": true,
  "provider": "nodemaven",
  "currency": "USDT",
  "plans": [
    { "traffic": "120 MB", "plan": "0.120", "price": 0.45 },
    { "traffic": "1 GB", "plan": "1", "price": 3.50 }
  ]
}

GET/pricing

Returns pricing for every active provider.

curl -H "Authorization: Bearer gpk_live_xxxxxxxxx" \
https://api.gateproxy.store/pricing

Account

Check account balance

GET/account/balance

Returns the current user balance for the API token.

{
  "success": true,
  "balance": 27.52,
  "currency": "USD"
}

Orders

Create proxy order

POST/orders

Create a proxy order. The API deducts balance, creates or delivers the proxy, records the order, and returns credentials.

Request body

{
  "provider": "nodemaven",
  "plan": "1GB"
}

cURL example

curl -X POST https://api.gateproxy.store/orders \
  -H "Authorization: Bearer gpk_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"provider":"nodemaven","plan":"1GB"}'

Success response

{
  "success": true,
  "order_id": "ord_9x1a8f",
  "status": "completed",
  "proxy": {
    "host": "proxy.server.com",
    "port": 8080,
    "username": "nodemaven_xxxxx-country-us",
    "password": "pass123",
    "protocol": "HTTP"
  }
}

Orders

Get order status

GET/orders/{order_id}

Returns a single order by ID. Only the owner of the API token can access the order.

curl -H "Authorization: Bearer gpk_live_xxxxxxxxx" \
https://api.gateproxy.store/orders/ord_9x1a8f

History

List user orders

GET/orders?limit=20&page=1

Returns paginated order history for the authenticated user.

curl -H "Authorization: Bearer gpk_live_xxxxxxxxx" \
"https://api.gateproxy.store/orders?limit=20&page=1"

Usage

Check proxy traffic usage

GET/proxies/{proxy_id}/{proxy_username}/usage

Check used and remaining traffic. Use order ID with auto for the easiest flow.

By order ID

curl -H "Authorization: Bearer gpk_live_xxxxxxxxx" \
"https://api.gateproxy.store/proxies/ord_9x1a8f/auto/usage"

By provider and username

curl -H "Authorization: Bearer gpk_live_xxxxxxxxx" \
"https://api.gateproxy.store/proxies/nodemaven/nodemaven_xxxxx-country-us/usage"

Response

{
  "success": true,
  "provider": "nodemaven",
  "proxy_username": "nodemaven_xxxxx-country-us",
  "used": "1.2GB",
  "remaining": "3.8GB",
  "total": "5GB",
  "order_id": "ord_9x1a8f"
}

ProxySeller usage

API data usage is not available for ProxySeller proxies. Use the Telegram checker bot:

https://t.me/proxysellergpbot

Errors

Error format and codes

{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Not enough balance."
  }
}

HTTP	Code	Meaning	Action
401	`unauthorized`	Missing, invalid, or revoked token.	Generate a new token.
404	`provider_not_found`	Provider ID is invalid.	Use a valid provider ID.
400	`invalid_plan`	Plan does not exist.	Load pricing first.
400	`invalid_json`	Request body is not valid JSON.	Set JSON body and content type.
402	`insufficient_balance`	Account balance is too low.	Deposit funds.
409	`order_processing`	Another order is running.	Retry after a few seconds.
502	`provider_error`	Provider or stock issue.	Check stock or retry later.
404	`order_not_found`	Order ID not found for this token.	Check the order ID.
404	`proxy_not_found`	Usage check target not found.	Use order ID or exact username.
400	`usage_not_available`	Provider has no API usage checker.	Use the provided checker bot/link.

Integration

Code examples

const axios = require("axios");

const api = axios.create({
  baseURL: "https://api.gateproxy.store",
  headers: {
    Authorization: "Bearer gpk_live_xxxxxxxxx",
    "Content-Type": "application/json"
  }
});

async function buyNodeMaven() {
  const res = await api.post("/orders", {
    provider: "nodemaven",
    plan: "1GB"
  });
  console.log(res.data);
}

buyNodeMaven();

import requests

API_BASE = "https://api.gateproxy.store"
API_TOKEN = "gpk_live_xxxxxxxxx"

headers = {
    "Authorization": f"Bearer {API_TOKEN}",
    "Content-Type": "application/json",
}

res = requests.post(
    f"{API_BASE}/orders",
    headers=headers,
    json={"provider": "nodemaven", "plan": "1GB"},
)

print(res.status_code)
print(res.json())

<?php
$apiBase = "https://api.gateproxy.store";
$apiToken = "gpk_live_xxxxxxxxx";

$ch = curl_init($apiBase . "/orders");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer " . $apiToken,
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  "provider" => "nodemaven",
  "plan" => "1GB"
]));

echo curl_exec($ch);
curl_close($ch);