Documentation — Nodetonet

Quickstart

The shortest path from "I just signed up" to "I'm tunneling traffic." For the longer walkthrough, see the how-to-use-nodetonet blog post.

Create an account at /auth/register and verify your email.
Copy your Personal API Key from the dashboard.
Top up $1 of service credit on /balance (Stripe-hosted checkout).
Pair an Android device — install the agent, paste the token from /tokens.
Create a proxy from /proxies → New Proxy.
Use the connection string returned: curl -x http://u:p@xxx.nodetonet.com:48888 https://api.ipify.org

Protocols supported

The panel lets you pick one of three protocols per proxy:

Protocol	Client compatibility	Use case
`HTTP`	Widest — curl, scrapers, browsers, Postman	Default — pick this first.
`SOCKS5`	TCP-level, more tools support it (Telegram, IRC, native apps)	When you need non-HTTP semantics.
`HTTPS`	For tools that require the proxy itself to use TLS	Encrypt the proxy hop.

REST API

All endpoints take Authorization: Bearer <key>. JSON in/out. Standard HTTP semantics (2xx success, 4xx your error, 5xx ours).

Base URL

https://nodetonet.com/api/v1

List proxies

curl -H "Authorization: Bearer $KEY" \\
  https://nodetonet.com/api/v1/proxies

Create a proxy

curl -X POST -H "Authorization: Bearer $KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "title": "scraper-01",
    "protocol": "http",
    "port": "auto",
    "serverId": "<edge-uuid>",
    "tokenId": "<your-token-uuid>"
  }' \\
  https://nodetonet.com/api/v1/proxies

Get usage stats

curl -H "Authorization: Bearer $KEY" \\
  https://nodetonet.com/api/v1/proxies/<id>/usage

Delete a proxy

curl -X DELETE -H "Authorization: Bearer $KEY" \\
  https://nodetonet.com/api/v1/proxies/<id>

The full OpenAPI 3.0 spec lives at /openapi.json — point your favourite codegen at it.

Upstream forwarding

Chain a third-party residential / rotating proxy behind your Nodetonet endpoint. Format: host:port:user:pass. The Nodetonet edge handles TLS termination, auth, sticky sessions, and billing; your upstream provides the actual exit IPs.

# In the New Proxy modal:
Upstream Proxy: gate.smartproxy.com:7000:user-country-de:pass

Username modifiers (-country-XX, -session-XXX, -sessionduration-N) pass through verbatim. See the upstream forwarding deep-dive.

Rate limits

API: 60 requests / minute / API key. 429 with Retry-After if exceeded.
Tunnel creation: 30 / hour / account. Prevents abuse, lift on request.
Auto-topup: 10-minute cooldown between off-session charges.

Billing

Prepaid. Top up service credit on /balance; per-day charge of ~$0.033/active tunnel deducts from credit at 03:00 UTC. Idle (status: stopped) tunnels don't charge. Auto-topup is opt-in — see managing payment methods.

Self-host (coming soon)

The full panel + edge runs on commodity Linux. Documentation for self-hosting the platform on your own hardware will land in Q3 2026. Get in touch if you want early access.

Need more?

Check the blog for tutorials, the community for questions, or email support.