Tpn Proxy

Examples

These show exactly what users ask and what you should respond. Study these — they are the gold standard.

User: "Give me a socks5 config for Belgium"

You: (generate a BE proxy yourself, then respond:)

Here's your Belgian SOCKS5 proxy (valid 60 minutes):

Host:     185.42.170.3
Port:     1080
Username: u_0CKaBqdE
Password: p_sT6yM3zabqRuhqrahzGOl4i4RTEDgQ7V
Scheme:   socks5h
Expires:  2026-02-16T15:30:00Z

Full URI: socks5h://u_0CKaBqdE:p_sT6yM3zabqRuhqrahzGOl4i4RTEDgQ7V@185.42.170.3:1080

curl example:

curl --proxy socks5h://u_0CKaBqdE:p_sT6yM3zabqRuhqrahzGOl4i4RTEDgQ7V@185.42.170.3:1080 \
  --connect-timeout 10 --max-time 30 \
  https://ipv4.icanhazip.com

This should return a Belgian IP. The proxy expires in 60 minutes — let me know if you need a longer lease.

User: "Show me a curl command that proxies over Germany"

You: (generate a DE proxy yourself, then respond:)

Here's a curl command routed through a German proxy:

curl --proxy socks5h://u_0E4k7kJ6:p_z2HsXTEXJHYiobwCcfOaU1YMS1tg3m0i@5.39.255.64:1080 \
  --connect-timeout 10 --max-time 30 \
  https://example.com

Replace https://example.com with your target URL. This proxy expires at 2026-02-16T14:47:20Z.

User: "Call icanhazip.com from the Netherlands"

You: (generate an NL proxy yourself, fetch icanhazip.com through it, then respond:)

I fetched https://ipv4.icanhazip.com through a Dutch proxy. The response:

82.148.30.91

That's the exit IP in the Netherlands. The proxy is still active until 2026-02-16T15:12:00Z if you need more requests.

User: "I need a residential US proxy for 2 hours"

You: (generate a US residential proxy with minutes=120, then respond:)

Here's your US residential proxy (valid 2 hours, 25 credits):

Host:     68.210.185.149
Port:     1080
Username: u_02NyffuT
Password: p_CIYLqgIyLZ1rSvZGQbdh3lyxQQBcBsQn
Scheme:   socks5h
Type:     residential
Expires:  2026-02-16T16:41:00Z

Full URI: socks5h://u_02NyffuT:p_CIYLqgIyLZ1rSvZGQbdh3lyxQQBcBsQn@68.210.185.149:1080

Residential IPs are less likely to be blocked. Let me know if you need a different country.

User: "How many credits do I have left?"

You: (call GET /api/v1/user/balance yourself, then respond:)

You have 74 credits remaining.

For reference, a 60-minute proxy costs 20 credits and a 10-minute proxy costs 10 credits. You can buy more at https://api.taoprivatenetwork.com — packages start at 1,000 credits for $9.99.

User: "Use a proxy to check if my site looks right from Germany"

You: (generate a DE proxy, fetch their site through it, then respond:)

I fetched your site through a German proxy (IP: 91.203.50.12):

• Status: 200 OK
• Content-Language: de — looks like your site detected the German IP and served the German version
• Page title: "Willkommen bei Example"

Everything seems to be working correctly for German visitors. Want me to check from another country?

User: "Set up TPN" / "How do I get started with TPN?"

You: (check if a key already exists — if yes, tell them they're set up; if no:)

To get started with TPN:

1. Go to https://api.taoprivatenetwork.com and create an account
2. From the dashboard, create an API key (it'll look like tpn-abc123...)
3. Your first key comes with 100 free credits — enough for about 5 one-hour proxies

Once you have the key, share it with me and I'll save it for future sessions. Then I can generate proxies for you anytime.

The pattern: the user asks, you act, you return results. You never tell the user how to call the API — you call it yourself and hand them the output.

API Reference

Base URL: https://api.taoprivatenetwork.com

Authentication: Pass X-API-Key: <your-key> as a request header. Not Authorization: Bearer.

Endpoints

Response shapes

/proxy/generate with format=text:

{
  "success": true,
  "vpnConfig": "socks5://u_02NyffuT:p_CIYLqgIyLZ1rSvZGQbdh3lyxQQBcBsQn@9.160.73.2:1080",
  "minutes": 60,
  "expiresAt": "2026-02-14T19:08:25.690Z",
  "creditsUsed": 20,
  "type": "socks5"
}

/proxy/generate with format=json:

{
  "success": true,
  "vpnConfig": {
    "username": "u_0CKaBqdE",
    "password": "p_sT6yM3zabqRuhqrahzGOl4i4RTEDgQ7V",
    "ip_address": "68.210.185.149",
    "port": 1080
  },
  "minutes": 60,
  "expiresAt": "2026-02-14T19:08:23.958Z",
  "creditsUsed": 20,
  "usedFallback": false,
  "type": "socks5",
  "connection_type": "any"
}

/vpn/countries query parameters

Using the proxy (for user-facing code examples)

Only show these if the user explicitly asks "how do I use this in my code?" — otherwise just hand them the config.

User-facing code should always use socks5h:// (with h) to resolve DNS through the proxy, preserving DNS privacy. (The agent uses socks5:// for its own fetching in Step 5, where local DNS resolution is a security feature — see Step 5.)

If proxy credentials contain special characters (@, :, /, #, ?), percent-encode them (e.g. p@ss → p%40ss).

curl:

curl --proxy socks5h://username:password@ip_address:port \
  --connect-timeout 10 --max-time 30 \
  https://ipv4.icanhazip.com

Node.js:

import { SocksProxyAgent } from 'socks-proxy-agent'
import fetch from 'node-fetch'

const agent = new SocksProxyAgent( 'socks5h://username:password@ip_address:1080' )
const controller = new AbortController()
const timeout = setTimeout( () => controller.abort(), 30_000 )

const response = await fetch( 'https://ipv4.icanhazip.com', { agent, signal: controller.signal } )
clearTimeout( timeout )
console.log( await response.text() )

Python:

import requests

proxies = {
    'http': 'socks5h://username:password@ip_address:1080',
    'https': 'socks5h://username:password@ip_address:1080'
}

response = requests.get( 'https://ipv4.icanhazip.com', proxies=proxies, timeout=( 10, 30 ) )
print( response.text )

See {baseDir}/references/api-examples.md for end-to-end examples (generate + use) in curl, JS, Node.js, and Python.

Credit Costs

Formula: credits = ceil( 4.1 × minutes ^ 0.375 )

Use POST /api/v1/vpn/cost with {"minutes": N} to calculate before purchasing.

Credit packages: Starter 1,000/$9.99 · Pro 5,000/$49.99 · Premium 20,000/$199.99

Troubleshooting & Operational Notes

Operational rules:

• User-facing credentials and code examples: always use socks5h:// for DNS privacy
• Agent-side fetching (Step 5): always use socks5:// so local DNS validation is authoritative
• Check credit balance with GET /api/v1/user/balance before generating proxies in bulk
• Proxy leases expire at expiresAt — never cache or reuse credentials beyond that time
• If a 503 occurs, credits are refunded automatically — retry after a short delay

x402 Payment Flow (Advanced)

The x402 protocol enables pay-per-request access using USDC on Base. No account or API key needed — ideal for autonomous agents that already support x402.

If you are an x402-capable agent, you already know how to handle the payment handshake. The TPN x402 endpoints follow the standard protocol:

1. POST /api/v1/x402/proxy/generate — returns HTTP 402 with a standard payment-required header
2. Complete the x402 payment flow per the protocol specification
3. Retry with the payment header to receive SOCKS5 credentials

Same request body as the centralised endpoint. No X-API-Key needed.

See {baseDir}/references/x402-examples.md for curl and browser JS examples, and the x402 spec for full protocol details. Signing is handled entirely by external libraries — this skill provides endpoint URLs only.

Links

• Dashboard & Account: https://api.taoprivatenetwork.com
• API Docs: https://api.taoprivatenetwork.com/docs/getting-started/
• Swagger UI: https://api.taoprivatenetwork.com/api-docs/
• OpenAPI Spec: https://api.taoprivatenetwork.com/api-docs/openapi.json
• LLM-friendly docs: https://api.taoprivatenetwork.com/docs/llms-full.txt
• x402 Protocol: https://www.x402.org