Use case

Proxies for Clash of Clans: API keys, several villages and the Supercell rules

A fixed IP for Clash of Clans API keys, how Supercell ID handles several villages, and what the Supercell terms say about emulators, bots and modified files.

HProxy Team··Updated September 28, 2026·6 min read
HProxy.Use case

Free proxies won't hold up here.

Shared datacenter IPs get flagged and dropped fast. When it has to hold, gaming, streaming, accounts, you need mobile and residential IPs that read as a real device, from $0.44/GB, pay as you go.

See plans & pricing→

Most people who search for a Clash of Clans proxy want one of three things. They want a fixed address for the Clash of Clans API, a way to run several villages, or a proxy app called Clash. This page answers from the Supercell developer site, Supercell Support and the Supercell terms, read on 28 September 2026, and from our own calls to the API. The short answer: the API needs a fixed IP, and a static proxy gives one. Several villages need Supercell ID, not a proxy. The terms bar emulators, bots and modified game files.

What people mean by a Clash of Clans proxy

searchwhat it isdoes a proxy help
a proxy for the APIa fixed IP for a keyyes, a static IP
several villagesseveral accountsno, Supercell ID does it
Clash, the proxy appanother proxy clientnot about the game
private serversmodified game filesno, the terms bar them

On Bing, the searches "clash of clans proxies" and "clash of clans proxy server" return a proxy client called Clash first. It shares the name and has nothing to do with the game.

The Clash of Clans API needs a fixed IP

Supercell runs an official API for Clash of Clans, with "access to game related data" for community tools, apps and websites. Its developer site sets one rule that matters here: "When creating a key you need to specify the IP addresses that are allowed to access the API endpoints".

The same site adds that the token "is bound to rate limitations and specified IP addresses, so you will need a web server to fetch data from the API and host your application". The key form rejects any address in a private range. By the code of the site, it holds five addresses unless an account has a higher limit.

We called the API from our own server on 28 September 2026. Without a key it answered 403 with "Missing authorization", and with a made-up key 403 with "Invalid authorization". The API and the game hosts both resolved to addresses registered to Amazon.

Where it breaks. A key made for one address fails from any other. So a home connection, or a host whose outgoing address changes, needs a new key after every change.

The fix is one fixed address. Send every API call through a proxy whose exit IP never changes, and list that IP on the key. Our static ISP proxies cost $2.70 per IP for a month, and datacenter IPv4 costs $1.58 per IP for a month. Rotating residential traffic, from $0.44/GB, changes its IP by design, so it cannot match a key.

A free community route exists too. RoyaleAPI documents a proxy for the Supercell APIs, Clash of Clans included, "If your server does not have a static IP address". You list its address on your key and send your calls to its host instead of the official one. Your key and every request then pass through a service that someone else runs.

How to call the API through a static proxy

  1. Buy one static IP and note its address.
  2. Create a key on the Clash of Clans developer site, and enter that address under "Allowed IP Addresses".
  3. Send every request through the proxy, with the key in the Authorization header.

In Python, with the requests library:

import requests

TOKEN = "your API key"
PROXY = "http://USER:PASS@PROXY_HOST:PORT"  # the static proxy whose IP is on the key

r = requests.get(
    "https://api.clashofclans.com/v1/players/%23YOURTAG",
    headers={"Authorization": f"Bearer {TOKEN}"},
    proxies={"https": PROXY},
    timeout=10,
)
print(r.status_code, r.json())

The same call with curl:

curl -x "http://USER:PASS@PROXY_HOST:PORT" \
  -H "Authorization: Bearer $TOKEN" \
  "https://api.clashofclans.com/v1/players/%23YOURTAG"

Write the "#" of a player tag as "%23". The URL standard, RFC 3986, ends the path at the first "#", so a raw one cuts the tag off before the request leaves. The open-source Python client coc.py offers an email and password login, which in its words "removes the stress of managing tokens". Our guides to proxies with Python requests and proxies with curl cover the proxy settings in more depth.

Several villages: Supercell ID, not a proxy

Supercell Support answers the question directly: "Supercell ID is the only supported method for playing several game accounts on the same device". You attach each game account to its own Supercell ID and keep "Remember me on this device" ticked. Then you switch between the accounts in the settings of the game.

Each account stays with one player. "Each game account should be used by just one player", Supercell says, and selling, buying, sharing or giving accounts is against its terms. A bought account carries its own risks, in the words of Supercell: "The account status is unknown; it could already be poised for a permanent ban".

What the Supercell rules say

The Supercell terms took effect on 6 November 2024. Their list of use limitations bars you from using "cheats, exploits, automation software, emulators, bots, hacks, mods or any unauthorized third-party software designed to modify or interfere with the Service". You may not "Modify or cause to be modified any files that are a part of the Service or any Supercell game" without written consent. And you may not use the service "if you have previously been removed by Supercell, or previously been banned from playing any Supercell game".

Supercell Support explains the penalties. A ban can last a few days, and repeat offenses bring longer ones, "7 days, or even 31 days". For "extreme offenses such as cheating, systematic account theft or illegal activity such as fraud", the ban is permanent. The Safe and Fair Play Policy adds that prohibited third-party software "will result in a permanent ban for any offending account(s)".

Two more warnings come up in searches. On free gems, Supercell says: "Never trust websites that offer free gems in return for your log-in details or passwords". And on 9 March 2022, Supercell removed its games from the app stores in Russia and Belarus. It said access for existing players would end with the next client update. This page gives no way around that block.

If you use proxies for other work

Nothing on this page routes the game through a proxy: the API needs a fixed address, and the game needs none of the jobs above. Our page on free proxies for Clash of Clans tests free proxies against the official site. Our page on proxies for Brawl Stars covers the same API rule for another Supercell game. For the basics, see what a residential proxy is, what a mobile proxy is and whether free proxies are safe. Our free proxy list and proxy checker cost nothing, and residential traffic starts at $0.44/GB.

The limits of this page

We did not play Clash of Clans, create a developer account or make a key. We called the API without a key, from one server in the United States. The RoyaleAPI page answered our server with a security check, so its text comes from an archive copy of 4 March 2026. DuckDuckGo, Mojeek and Brave refused or did not answer our searches, so the ranking above is the ranking of Bing. This page is due for a check by 28 December 2026.

Sources

We read every source below on 28 September 2026.

More pages in this series: proxies for Brawl Stars, proxies for Call of Duty and proxies for Minecraft.

Frequently asked questions

What is a Clash of Clans proxy server?
Most often, a fixed address for the Clash of Clans API. Each API key only works from the IP addresses you list when you create it, so a bot or a stats site on a changing address sends its calls through a proxy with one fixed IP. Clash is also the name of an unrelated proxy app.
Why does the Clash of Clans API need a static IP?
When you create a key, you list the IP addresses allowed to use it, and the form refuses private addresses. If the public address of your server changes, your calls fail until you make a new key or list the new address.
Can I play several Clash of Clans accounts on one device?
Yes. Supercell Support says Supercell ID is the only supported method for playing several game accounts on the same device. It needs no proxy.
Are emulators allowed in Clash of Clans?
The Supercell terms list emulators among the tools you may not use, next to cheats, automation software, bots, hacks and mods. They also bar modifying the files of any Supercell game without the written consent of Supercell.
Can a proxy bring back a banned Clash of Clans account?
No. The Supercell terms say you may not use the service if you have been removed by Supercell or banned from any Supercell game. Supercell bans for a few days up to 31 days, and permanently for extreme offenses such as cheating.

Proxies that don't die mid-job

Residential, ISP, datacenter and mobile, verified by the same engine that runs tens of millions of checks. They read as a real device and hold up under load. Pay as you go, and your balance never expires. $0.44/GB is the 2,000 GB+ rate; a single gigabyte is $0.50/GB, with no minimum order.

129M+ proxy checks run · 100+ countries · HTTP / HTTPS / SOCKS · re-checked every few minutes · no signup

HProxy.

Honest guides and comparisons on proxies, scraping and staying unblocked, from the team that runs the network.

RSS feed