NightNodes Whitepaper

Everything you need to get up and running with NightNodes — from your first top-up to advanced proxy integration. This guide covers all products, billing, and best practices.

01 Account & Top-up

NightNodes uses a prepaid wallet model. You top up your account balance and spend it across any product — no subscriptions, no auto-charges.

Register an Account

Top-up & Payment

02 Quick Start

From sign-up to your first proxy request in under 5 minutes.

# Quick test — replace with your credentials
curl -x "http://username:password@gate.nightnodes.io:7000" \
     "https://httpbin.org/ip"

03 Dynamic Residential Proxies

Real residential IPs sourced from consenting device owners across 160+ countries. Billed per GB of traffic — unused traffic never expires.

Key Features

• 125M+ IP pool — fresh IPs on every request (rotating) or sticky sessions up to 30 minutes
• City, state, and ZIP-level targeting
• HTTP(S) and SOCKS5 support
• Traffic never expires — buy in bulk and use over time
• 99.98% success rate on major e-commerce and social platforms

Connection Format

# Rotating (new IP each request)
Host:  gate.nightnodes.io
Port:  7000 (HTTP) / 7001 (SOCKS5)
User:  your_username
Pass:  your_password

# Sticky session (same IP for up to 30 min)
User:  your_username-session-abc123

Country & City Targeting

# Target United States, New York
User:  your_username-country-us-city-newyork

# Target United Kingdom
User:  your_username-country-gb

04 Static Residential Proxies (ISP)

Dedicated IPs registered under real residential ISPs, hosted on datacenter infrastructure. Same IP for the full duration — ideal for accounts, long sessions, and platforms that detect datacenter IPs.

Key Features

• Fixed IP assigned to you for the entire plan period (1–365 days)
• Unmetered bandwidth — no per-GB charges
• HTTP(S) and SOCKS5
• Multiple countries and cities available
• Bulk discounts for 3, 6, and 12-month plans

How to Purchase

1. Go to Static Residential in the left sidebar
2. Select country, city, quantity, and duration
3. Apply a discount code if you have one
4. Click Buy Now — credentials appear in Orders within seconds

05 ECS Hosting

Elastic Cloud Servers deployed in Ashburn, VA. Root access, 10Gbps uplink, 10TB monthly bandwidth. Ideal for running bots, scraping frameworks, or VPN endpoints.

Server Specs

Accessing Your Server

# SSH into your ECS server
ssh root@<your-server-ip> -p 22

# Or use the password provided in your order

06 API Access

NightNodes provides a REST API to manage your account, generate proxy credentials, and check usage — all programmatically. No rate limits on developer accounts.

Authentication

Generate an API key from Developer → API Access in your dashboard. Pass it in the request header:

X-API-Key: your_api_key_here

Key Endpoints

# Get account info
curl https://nightnodes.com/api/v1/account \
  -H "X-API-Key: YOUR_KEY"

# Response
{
  "balance": 42.50,
  "username": "your_username",
  "resi_gb_remaining": 12.4
}

07 Integration Guide

NightNodes proxies work with any tool that supports HTTP/HTTPS or SOCKS5. Here are examples for the most common use cases.

Python — requests

import requests

proxies = {
  "http":  "http://user:pass@gate.nightnodes.io:7000",
  "https": "http://user:pass@gate.nightnodes.io:7000",
}
r = requests.get("https://httpbin.org/ip", proxies=proxies)
print(r.json())

Node.js — axios

const axios = require('axios');
const { HttpsProxyAgent } = require('https-proxy-agent');

const agent = new HttpsProxyAgent(
  'http://user:pass@gate.nightnodes.io:7000'
);
const res = await axios.get('https://httpbin.org/ip', { httpsAgent: agent });
console.log(res.data);

Playwright / Puppeteer

const browser = await playwright.chromium.launch({
  proxy: {
    server: 'http://gate.nightnodes.io:7000',
    username: 'your_username',
    password: 'your_password',
  }
});

Scrapy (Python)

# settings.py
ROTATING_PROXY_LIST = [
  'http://user:pass@gate.nightnodes.io:7000',
]

08 Best Practices

Session Management

• Use rotating mode for large-scale scraping where each request needs a fresh IP
• Use sticky sessions for login flows, cart management, or multi-step processes
• Keep sticky sessions short (under 10 min) to maximize IP freshness

Geographic Targeting

• Always target the same country as your target site to minimize block rates
• For localized pricing data, use city-level targeting
• Static Residential is recommended for platforms that require consistent geo (streaming, banking)

Request Rate

• Respect robots.txt and target site rate limits to avoid IP blocks
• Add randomized delays (1–5s) between requests to mimic human behavior
• Rotate User-Agent headers alongside IP rotation

09 Billing & Refunds

NightNodes uses a prepaid wallet — no surprise charges. Top up once, spend across any product.

How Billing Works

• Dynamic Residential: Deducted per GB used. Unused GB never expires.
• Static Residential: Deducted upfront for the full period (1–365 days).
• ECS Hosting: Deducted upfront for the subscription period.
• Promotional bonus: System-gifted credits applied automatically — not refundable.

Refund Policy Summary

→ Full Refund Policy

10 Referral Program

Earn commissions by referring new users to NightNodes. Your commission rate grows with the number of active referrals.

11 Support

Our team is online 24/7. Average first response: 90 seconds.