Quickstart

From a new account to your first request through the proxy, step by step.

Four steps

1. Create your account

   Sign up at app.littenhub.com. You only need an email and a password.

2. Add GB to your balance

   In the dashboard, open Plans, choose a proxy type and how many GB you want, and pay by card. Your balance never expires.

3. Copy your credentials

   Open the Proxy page of the dashboard. You'll find the host, port, username and password, ready to copy:

   gw.littencaptcha.com:8080:USERNAME:PASSWORD

4. Send your first request

   Replace USERNAME and PASSWORD with your credentials and run:

   curl -x "http://USERNAME:PASSWORD@gw.littencaptcha.com:8080" \
     "https://api.ipify.org?format=json"

   import requests
   
   proxy = "http://USERNAME:PASSWORD@gw.littencaptcha.com:8080"
   r = requests.get("https://api.ipify.org?format=json",
                    proxies={"http": proxy, "https": proxy}, timeout=30)
   print(r.json())

   import { ProxyAgent, fetch } from "undici";
   
   const dispatcher = new ProxyAgent("http://USERNAME:PASSWORD@gw.littencaptcha.com:8080");
   const res = await fetch("https://api.ipify.org?format=json", { dispatcher });
   console.log(await res.json());

   The response shows the IP your request came from: one of our proxy IPs, not yours.

Next steps

Connect to the proxy

One host for every proxy type. Each product has its own port, username and password, over HTTP or SOCKS5.

Your credentials

Protocols

HTTP and SOCKS5 share the same host and port. The proxy detects the protocol automatically.

• HTTP / HTTPS: a standard HTTP proxy. HTTPS sites go through a CONNECT tunnel, so your traffic stays encrypted end to end.
• SOCKS5: with username and password authentication. Use socks5h:// so that DNS is resolved by the proxy too.

Proxy formats

Most tools accept one of these formats:

Code examples

# HTTP / HTTPS
curl -x "http://USERNAME:PASSWORD@gw.littencaptcha.com:8080" \
  "https://api.ipify.org?format=json"

# SOCKS5 (same port)
curl -x "socks5h://USERNAME:PASSWORD@gw.littencaptcha.com:8080" \
  "https://api.ipify.org?format=json"

import requests

proxy = "http://USERNAME:PASSWORD@gw.littencaptcha.com:8080"
# SOCKS5: proxy = "socks5h://USERNAME:PASSWORD@gw.littencaptcha.com:8080"  (pip install requests[socks])

r = requests.get("https://api.ipify.org?format=json",
                 proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.json())

// npm install undici
import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME:PASSWORD@gw.littencaptcha.com:8080");
const res = await fetch("https://api.ipify.org?format=json", { dispatcher });
console.log(await res.json());

How IPs rotate

Each new connection goes out through an available IP of your proxy type, so consecutive connections usually get different IPs. Requests sent over the same connection keep the same IP.

Usage and limits

• Traffic is counted in both directions (upload and download) and deducted from your balance. See Proxy types & billing.
• Each account can keep a limited number of simultaneous connections. Above that limit, new connections get 429.
• Some destinations are blocked to prevent abuse.

Country targeting

Choose the country your requests come from by adding a flag to your username.

Username format

Add _cr. and a two-letter country code (ISO 3166-1) to the end of your username. The password doesn't change.

USERNAME_cr.us

# Exit from Germany
curl -x "http://USERNAME_cr.de:PASSWORD@gw.littencaptcha.com:8080" \
  "https://api.ipify.org?format=json"

import requests

proxy = "http://USERNAME_cr.de:PASSWORD@gw.littencaptcha.com:8080"
r = requests.get("https://api.ipify.org?format=json",
                 proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.json())

import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME_cr.de:PASSWORD@gw.littencaptcha.com:8080");
const res = await fetch("https://api.ipify.org?format=json", { dispatcher });
console.log(await res.json());

Available countries

The countries depend on the IPs online for your proxy type at each moment. Get the current list with GET /proxy/countries, or pick a country on the Proxy page of the dashboard, which builds the username for you.

If a country isn't available

If there's no IP available in that country, the proxy answers 503 Service Unavailable over HTTP, or a general failure over SOCKS5. Try another country, or remove the flag to use any country.

Proxy types & billing

Pay only for the traffic you use. Your balance is measured in GB and never expires.

Proxy types

Prices are in US dollars. You can always get the current prices with GET /pricing.

How traffic is measured

• Both upload and download count. 1 GB = 1,000,000,000 bytes.
• Traffic is deducted from your balance as you use it. Check it in the dashboard or with GET /me and GET /usage.
• When your balance reaches zero, new connections are refused with 403 until you add more GB.

Separate products

Each proxy type is a separate product with its own balance, username, password and port. You can have several at once, and buying one never changes the others.

Buying GB

Buy GB in the dashboard under Plans with a one-time card payment: no subscriptions and no auto-renewal. Every purchase appears in Invoices.

Proxy errors

What each proxy response means and how to fix it.

Response codes

Quick checklist

• Use your product's port for both HTTP and SOCKS5: 8080 residential, 8888 premium, 9090 datacenter.
• If you choose a country, the username must end in _cr.xx.
• Test with curl -x against https://api.ipify.org to rule out problems in your code.
• Still stuck? Write to us from Support in the dashboard.

VPN app

Protect your connection with LittenVPN: WireGuard® encryption and locations around the world, one click away.

Get the app

The app is available in beta for Windows, macOS and Linux. Apps for iPhone, iPad and Android are coming soon.

Download the app

Connect in three steps

1. Install

   Run the installer and open LittenVPN.

2. Sign in

   Use the same email and password as your dashboard account.

3. Connect

   Press Quick connect or choose a location from the list.

VPN plans

VPN plans are one-time payments for 1, 12 or 24 months, with no auto-renewal. Buy one in the dashboard under Plans → VPN. If you already have a plan, the new period is added to the time you have left.

See VPN prices

Good to know

• Your VPN plan and your proxy balance are separate: the VPN doesn't use GB from your balance.
• You can add free VPN days by redeeming a code.

API overview

Automate your LittenHub account: check your balance and usage, manage access tokens and more.

Base URL

https://littenhub.com/api/v1

All endpoints are relative to this URL and use JSON over HTTPS. The unversioned /api prefix still works, but it's deprecated.

Your first API call

Create an access token in the dashboard under Account & settings → API keys, save it in an environment variable and call GET /me:

export LP_TOKEN="lp_live_..."

curl https://littenhub.com/api/v1/me \
  -H "Authorization: Bearer $LP_TOKEN"

import os, requests

r = requests.get("https://littenhub.com/api/v1/me",
                 headers={"Authorization": f"Bearer {os.environ['LP_TOKEN']}"})
print(r.json())

const res = await fetch("https://littenhub.com/api/v1/me", {
  headers: { Authorization: `Bearer ${process.env.LP_TOKEN}` },
});
console.log(await res.json());

Conventions

• Traffic is expressed in bytes. 1 GB = 1,000,000,000 bytes.
• Prices are in US dollar cents (amountCents, perGbCents), except amt in invoices, which is in dollars.
• Dates use ISO 8601 in UTC (2026-10-11T09:30:00Z) or the YYYY-MM-DD format.
• IDs are UUIDs.

Endpoints

Authentication

Every API request, except for a few public endpoints, must be authenticated with a Bearer token.

Access tokens

Access tokens are the recommended way to use the API from scripts and servers. They start with lp_live_, don't expire and can be revoked at any time.

• Create one in the dashboard under Account & settings → API keys, or with POST /keys.
• The full token is only shown once. We store just its SHA-256 hash.
• Each account can have up to 20 active tokens.

Send it in the header of every request:

Authorization: Bearer lp_live_0123456789abcdef0123456789abcdef01234567

Session tokens

The dashboard and the LittenVPN apps sign in with your email and password (protected by a captcha) and receive two tokens:

When the access token expires, POST /refresh returns a new one and replaces the refresh token, so each refresh token works only once. POST /logout revokes it.

Errors

The API uses standard HTTP status codes and returns errors as JSON.

Error format

{ "error": "Not signed in" }

Some endpoints also return a machine-readable reason, such as POST /redeem:

{ "error": "This code has expired", "reason": "expired" }

Status codes

Rate limits

Some endpoints limit how often they can be called to protect your account. Going over a limit returns 429.

API limits

Other endpoints have no fixed limit, but please keep a reasonable pace: checking your balance or usage once a minute is plenty.

Proxy connections

The proxy limits the number of simultaneous connections per account. Above that limit, new connections get 429 over HTTP or a general failure over SOCKS5.

This page doesn't exist

It may have moved. Use the menu or the search to find what you're looking for.

Go to the documentation home