Proxy API

A lightweight, unauthenticated JSON endpoint that exposes the current MTProto proxy list for third-party integrations.

Endpoint

GET /proxies.json

Updated whenever the proxy list changes. Client should handle caching and fallback.

Response Format

The endpoint returns either an object with proxies or a bare array. Current schema:

{
  "updated_at": "2025-12-09T00:00:00Z",
  "proxies": [
    {
      "location": "Singapore1",
      "flag": "🇸🇬",
      "server": "213.35.101.202",
      "domain": "mtpsg1.onetaplink.app",
      "port": "12432",
      "secret": "dd5a066251675f4263f8d8b931f72fff6c",
      "ping": "115ms",
      "speed": "Fast",
      "status": "online",
      "link": "tg://proxy?server=213.35.101.202&port=12432&secret=dd5a066251675f4263f8d8b931f72fff6c"
    }
  ]
}

Field Description

FieldDescription
updated_atUTC timestamp when the list was generated.
proxiesArray of proxy entries.
locationHuman-readable node name.
flagCountry flag emoji.
serverIPv4/hostname for MTProto (Apple devices use this).
domainOptional domain; non-Apple devices prefer this when present.
portMTProto port.
secretMTProto secret.
pingLatency string for display.
speedQualitative speed label.
statusonline / slow / offline.
linkReady-to-use Telegram deep-link; if missing, build it with tg://proxy?server={host}&port={port}&secret={secret}.

Usage Examples

JavaScript (browser)

fetch('/proxies.json', { cache: 'no-store' })
  .then(res => res.json())
  .then(data => {
    const list = Array.isArray(data) ? data : data.proxies;
    console.log('proxies', list);
  });

cURL

curl -s https://www.mtproto.shop/proxies.json

Notes