Integrate in minutes, not days.

Authentication

Every request authenticates via standard proxy Basic Auth, embedded directly in the connection URL — no separate API key or OAuth flow. The username itself encodes your plan and routing options.

protocol://username:<pass>@gate.bifrostnetwork.cc:9521

Rotate your password anytime from the Telegram bot's account menu — active sessions using the old password are cut over on their next connection.

Endpoint & Session Syntax

The username is a dash-delimited string: your plan code, account ID, and any number of routing modifiers.

<plan>.base_<account_id>-country-us-session-3439b03c-ttl-300

Protocols

The same gateway and credentials work across all three — pick a protocol per-request, no separate accounts needed.

Geo & ASN Targeting

Narrow the exit pool by ISO country code or carrier ASN (residential plans support ASN targeting). Unsupported combinations automatically fall back to the nearest matching tier.

resi.eco_b28ed8682f-country-us-asn-7018

Code Examples

curl

$ curl -x socks5h://resi.eco_b28ed8682f-country-us-session-288ed66a:<pass>@gate.bifrostnetwork.cc:9521 https://httpbin.org/ip

Python (requests)

# pip install "requests[socks]"
import requests

proxy = "socks5h://resi.eco_b28ed8682f-country-us-session-288ed66a:@gate.bifrostnetwork.cc:9521"
r = requests.get("https://httpbin.org/ip", proxies={"http": proxy, "https": proxy})
print(r.json())

Node.js

// npm install socks-proxy-agent
import { SocksProxyAgent } from "socks-proxy-agent";

const agent = new SocksProxyAgent(
  "socks5h://resi.eco_b28ed8682f-country-us-session-288ed66a:@gate.bifrostnetwork.cc:9521"
);
const res = await fetch("https://httpbin.org/ip", { agent });
console.log(await res.json());

Troubleshooting

Using the Chrome Extension

Bifrost Proxy Manager is a Manifest V3 Chrome extension that connects to the official Bifrost proxy — or any HTTP/HTTPS/SOCKS5 proxy — without leaving your browser. This section covers install, setup, and troubleshooting.

Install

1. Install Bifrost Proxy Manager from the Chrome Web Store.
2. Pin the extension to your toolbar for one-click access.
3. Click the icon to open the popup — this is where you'll switch modes, manage profiles, and check your connection.

Connect With Your Account Token

To use the official Bifrost proxy network through the extension, you need an account token instead of a plan connection string.

1. Log in to your dashboard and copy your account token from Settings → Account API Token.
2. Open the extension popup, go to Settings, and paste the token into Bifrost Account API Token.
3. Back in the main popup, select Bifrost Official Proxy as the mode, choose a plan and target region, and click Enable Proxy.

Once your token is set, the popup automatically fetches your purchased plans, available regions, and gateway credentials — no need to construct a connection string by hand.

Custom Proxy Profiles

If you're not using the official Bifrost network — or want to switch between several proxies you already run — use Custom Proxy Profile mode.

Save as many profiles as you need. Switching between them — or back to the official Bifrost proxy — is one click in the popup; none of your saved credentials need to be re-entered.

Verify Your Connection

Every time you enable a proxy, the popup runs an exit IP and geolocation check automatically. The result is shown directly under the connection toggle, so you can confirm the switch actually took effect before you start browsing.

Bypass List

Local and internal addresses can be kept on a direct connection regardless of which proxy mode is active. In Settings → Bypass List, add one rule per line:

<local>
127.0.0.1
localhost
*.local
192.168.0.0/16

Auto Sign-In

For proxies that require authentication, the extension supplies your saved username and password via Chrome's chrome.webRequest authentication API. This means:

• No login popup ever appears, even on proxies that would normally prompt Chrome's native auth dialog.
• Credentials stay in Chrome's local extension storage — they're never synced to a third-party server, only sent to the proxy itself (or the Bifrost API, for official-proxy mode).

Troubleshooting

Using BifrostBrowser

BifrostBrowser is a fingerprint (anti-detect) browser included free with every Bifrost proxy account. Each profile is a fully isolated environment — its own cookies, cache, and a coherent hardware/software fingerprint — with proxies and fingerprint templates managed from the same app.

Install

Download the build for your OS from the BifrostBrowser download section — the page auto-detects your system and recommends the right installer.

If macOS reports "BifrostBrowser.app is damaged and can't be opened," this is Gatekeeper quarantining an unsigned app, not a corrupted download. Clear it from Terminal:

sudo xattr -rd com.apple.quarantine /Applications/BifrostBrowser.app

On first launch, open Settings → BifrostNetwork Account Token, paste the token from your dashboard user menu, and click Open Browser to Login to link the app to your account.

Workspace Overview

• Workspace — Browsers (your profile list — name, status, proxy, notes, last used) and Proxies (your saved proxy pool).
• Library — Fingerprints, a browsable set of real-device fingerprint templates.
• System — Settings.

The Browsers dashboard shows live counts across the top: total profiles, how many are currently running, saved proxies, and fingerprints available in your library.

Create a Profile

From Browsers, click + New profile (or From template to start from a curated fingerprint instead of building one field-by-field). The editor is grouped into five sections:

Click Create profile when done.

Fingerprint Library

Library → Fingerprints holds the device snapshots that populate the GPU/device selector in the profile editor. Templates are organized by OS (macOS, Windows, Linux) and named by device (e.g. mac-m1-air13, mac-m2-pro-mbp14), each tagged with a Chrome version and renderer string pulled from a real machine. Click Use → on any card to start a new profile from it, or expand the library with Import from file or + Paste JSON using a fingerprint exported from another working BifrostBrowser profile.

Add a Proxy

Go to Proxies and use the BifrostNetwork Proxy Quick Generator to pull directly from your purchased plans instead of hand-typing connection strings:

Click Generate and batch import to create and add them straight to your Proxies list, ready to attach to any profile. This uses the same account and plans as the rest of the Bifrost gateway — see the endpoint syntax above if you'd rather build a connection string manually.

Automation API

BifrostBrowser exposes a local HTTP API for scripting — create, launch, and close profiles, and fetch a CDP WebSocket URL to drive them with Playwright, Puppeteer, or any CDP-compatible client.

• Binds to 127.0.0.1 only — not reachable from other machines.
• Auth: JWT Bearer token — send Authorization: Bearer <token>.
• Default port: 40325, shown as the Base URL and pinned at the bottom of the sidebar for quick copying.

GET/POST http://127.0.0.1:40325/...
Authorization: Bearer <token>

Settings Reference

Troubleshooting

Next Steps