API documentation

Everything you need to authenticate, connect through a mobile exit, and monitor usage from your application.

Quick start

Go from account creation to your first mobile-exit request in four steps.

1

Create an account

Sign up and you are taken straight to the console.

2

Get your API key

Copy the account API key from the console. You can rotate it at any time.

3

Request credentials

Use the API key to retrieve SOCKS5, HTTP, and HTTPS connection details.

4

Connect your application

Add the returned credentials to your proxy client and send the first request.

1. Retrieve credentials with your API key
curl "https://www.gaofengxt.cn/api/v1/credentials" \
  -H "Authorization: Bearer YOUR_API_KEY"
2. Send the first request with those credentials
curl -x proxy.gaofengxt.cn:20001 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou:YOUR_PASSWORD" \
  https://ipinfo.io
Proxy access

Use the same mobile proxy credentials and switch between rotating and sticky behavior in the username.

ItemValue
HTTP / HTTPS gatewayproxy.gaofengxt.cn:20001
SOCKS5 gatewayproxy.gaofengxt.cn:20002
ProtocolsSOCKS5 / HTTP / HTTPS (different ports)
AuthenticationUsername and password

Two session modes

A username without session fields rotates. Adding both session and sessTime enables a sticky session.

Rotating mode

A new exit is scheduled for each new connection. The username ends after region.

Rotating mode
curl -x proxy.gaofengxt.cn:20001 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou:YOUR_PASSWORD" \
  https://ipinfo.io

Sticky session mode

The same session retains one exit IP for the number of minutes in sessTime.

session is your custom identifier; sessTime is the duration in minutes. The current gateway default maximum is 1,440 minutes.

Sticky mode · retained for 5 minutes
curl -x proxy.gaofengxt.cn:20001 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou-session-demo230pnqdnf-sessTime-5:YOUR_PASSWORD" \
  https://ipinfo.io

Username fields

Field order is fixed. Sticky mode requires both session and sessTime.

ParameterFormatExampleDescription
region-zone-mob-region-<region-code>-zone-mob-region-hangzhouSelects the mobile exit region and forms part of every username.
session-session-<session-id>-session-demo230pnqdnfYour sticky-session identifier; omit it in rotating mode.
sessTime-sessTime-<minutes>-sessTime-5Sticky duration in minutes; must appear together with session.
Complete sticky-session example
curl -x proxy.gaofengxt.cn:20001 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou-session-demo230pnqdnf-sessTime-5:YOUR_PASSWORD" \
  https://ipinfo.io
Language examples

Production-ready SOCKS5, HTTP, and HTTPS examples for each supported language.

curl --socks5-hostname proxy.gaofengxt.cn:20002 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou:YOUR_PASSWORD" \
  https://ipinfo.io
REST API

Retrieve credentials, balance, and usage through a consistent JSON API.

Base URL https://www.gaofengxt.cn/api/v1, with the following request header: Authorization: Bearer API_KEY.

Each account has one API key. Rotating it in the console invalidates the previous key immediately.

Traffic and usage values are integer byte counts (for example, 5368709120 is approximately 5 GiB); convert them into display units in your client. The one exception is balanceCNY, which is denominated in CNY.

The username returned by credentials is the account-level username. Append the region and session fields described in the Proxy access section when you connect.

GET/credentials

Retrieve proxy connection details (gateway, port, and account credentials)

Request
curl "https://www.gaofengxt.cn/api/v1/credentials" \
  -H "Authorization: Bearer tk_9f2kQwZ7ndLpXvR4tsBmHy6eUcAj3TgKrWn5PdVx"
Response
{
  "code": 200,
  "message": "ok",
  "data": {
    "host": "proxy.gaofengxt.cn",
    "port": 20001,
    "protocols": [
      "socks5",
      "http",
      "https"
    ],
    "endpoints": {
      "http": {
        "host": "proxy.gaofengxt.cn",
        "port": 20001
      },
      "https": {
        "host": "proxy.gaofengxt.cn",
        "port": 20001
      },
      "socks5": {
        "host": "proxy.gaofengxt.cn",
        "port": 20002
      }
    },
    "username": "ipx_demo8f2k",
    "password": "YOUR_PASSWORD",
    "rotatedAt": "2026-07-20T08:12:44.000Z"
  }
}
GET/account/balance

Get account balance and the current traffic pool

Request
curl "https://www.gaofengxt.cn/api/v1/account/balance" \
  -H "Authorization: Bearer tk_9f2kQwZ7ndLpXvR4tsBmHy6eUcAj3TgKrWn5PdVx"
Response
{
  "code": 200,
  "message": "ok",
  "data": {
    "balanceCNY": 328.5,
    "traffic": {
      "purchasedBytes": 214748364800,
      "usedBytes": 53687091200,
      "remainingBytes": 161061273600,
      "expiresAt": "2026-10-01T00:00:00.000Z"
    }
  }
}
GET/traffic?days=30

Get daily traffic usage; days is optional, defaults to 30, and accepts 1–360

Request
curl "https://www.gaofengxt.cn/api/v1/traffic?days=30" \
  -H "Authorization: Bearer tk_9f2kQwZ7ndLpXvR4tsBmHy6eUcAj3TgKrWn5PdVx"
Response
{
  "code": 200,
  "message": "ok",
  "data": {
    "days": 30,
    "byDay": [
      {
        "date": "2026-07-29",
        "bytes": 6120328396
      },
      {
        "date": "2026-07-30",
        "bytes": 4294967296
      }
    ],
    "totalBytes": 161061273600
  }
}
Errors and rate limits

A consistent error contract and one predictable rate-limit policy for retries and fallback handling.

CodeHTTP statusDescription
200200Request completed successfully
40001400Validation failed; check the request parameters (for example, days outside 1–360)
40101401Authentication failed; the Authorization header is missing or the API key is invalid (reset)
40301403The account is suspended, or the target is blocked by gateway policy
42901429Rate limit exceeded; retry according to Retry-After
50001500Internal service error; retry or contact support

Rate-limit policy

All traffic packages allow unlimited concurrent connections. The open REST API is limited to 200 RPS per API key (fixed one-second window); requests above the threshold return HTTP 429 with code 42901, so retry according to Retry-After.

Need gateway credentials?

Create an account, open the console, and run your first request in a few minutes.

View pricingCreate account