Falcon Proxy — API Documentation

Quick Start

Get a proxy with a simple request:

Request:

curl -X GET "https://proxy.falconcyber.online/v1/proxies?key=YOUR_API_KEY&limit=5&type=socks5"

Response:

{
  "status": "ok",
  "plan": "pro",
  "count": 5,
  "proxies": [
    {"proxy": "45.144.54.40:1080", "cc": "DE", "country": "Germany", "rtt": 140}
  ]
}

Authentication

Pass your API key as a key query parameter:

curl "https://proxy.falconcyber.online/v1/proxies?key=YOUR_API_KEY&limit=5"

Parameters

Parameter	Type	Example	Description
`limit`	integer	5	Number of proxies requested.
`type`	string	http	Protocol: http, https or socks5.
`country`	string	US	Two-letter country code.
`format`	string	json	Response format where supported.

Response Format

Successful responses return an ok status plus the requested data.

Code Examples

Endpoints:

GET/v1/proxies

Get live proxies (with country flags). Params: key, limit, type (socks5/http/all), country (RU, US...), format (txt/json).

GET/v1/rotate

Request a fresh proxy from the available pool.

GET/v1/status

Read API key status and plan information.

GET/v1/pricing

Return current plan information.

POST/v1/register

Create a FREE account and get an API key.

POST/v1/upgrade

Activate a purchased key (XXXX-XXXX-XXXX-XXXX).

POST/v1/payment

Create a USDT TRC-20 payment request.

POST/v1/payment/status

Check payment request status by order_id.

cURL:

curl "https://proxy.falconcyber.online/v1/proxies?key=YOUR_API_KEY&limit=5&type=socks5&format=json"

Python:

import requests
KEY = "YOUR_API_KEY"
r = requests.get("https://proxy.falconcyber.online/v1/proxies",
                 params={"key": KEY, "limit": 10, "type": "socks5", "format": "json"})
print(r.json())

Error Codes

{
  "status": "error",
  "error": "invalid_api_key",
  "message": "The supplied API key is invalid."
}

Code	Meaning
`400`	Invalid parameters
`401`	Invalid API key
`404`	Endpoint not found
`429`	Daily limit exceeded
`503`	Proxy pool empty — try again later

Rate Limits

Plan	Daily requests	Proxies
FREE	100	5
START	5 000	50
PRO	50 000	200
BUSINESS	∞	1 000

Support

Contact us anytime, we're here to help.

Telegram: @falcon_cyber · Email: admin@falconcyber.online

Proxy API