FAQ & troubleshooting
General
Section titled “General”What is a Marvel exit?
A single residential egress — a node — that has cleared all enforced gates of the
Gauntlet before it could enter the Reserve. You reach it through one HTTP proxy
endpoint, resi.marvel.sh:9000.
What protocol does the proxy speak?
Standard HTTP proxy with CONNECT. Point any HTTP- or HTTPS-bound client — curl, requests, axios,
Playwright, your scraper — at it; HTTPS targets tunnel through transparently.
Why can’t I pick a city, state, ASN, or ISP? Targeting is country-only by design. The Integrity gate targets ASN on the inside — re-resolving and allowlisting it — precisely so a customer can’t pin an arbitrary ASN and drag datacenter or reseller ranges into a residential pool. Country in, vetted residential exit out.
Sessions & selection
Section titled “Sessions & selection”Sticky or rotating?
Omit a session for a fresh exit per request (rotating); add -session-<id> to reuse the same exit
(sticky). Details in Sessions & the Reserve.
What grade will I get?
The selector serves the best available grade first — S then
A then B — so you get the
highest live quality by default. Add min_purity to enforce a floor.
Why did my country return 503?
Capacity is honest and live-only: if a country has no vetted exits this moment, you get 503
instead of a silent reroute. Check GET /v1/availability.
The Gauntlet
Section titled “The Gauntlet”Is the Oracle filtering my traffic? Not today. The Oracle is built and trained and records features on every candidate, but it is not yet in the gate path — four gates (Integrity, Fingerprint, Reputation, Exposure) enforce right now. We’ll say so the day that changes. See The Gauntlet.
Can I see why an address was rejected?
Drops happen before a node ever reaches you — that’s the point. For exits you do receive, the full
verdict (Purity, Grade, Seals) is on every node from /v1/nodes.
Billing & keys
Section titled “Billing & keys”How am I billed? Prepaid bundles, metered by bytes proxied — nothing else. Dropped re-draws, idle sessions, and the Gauntlet are free. See Pricing & bundles.
I paid but my balance is still zero.
Credit applies when Stripe’s signature-verified webhook confirms the payment, not on the redirect
back. It settles in moments; confirm with GET /v1/usage.
I lost an API key.
Keys are shown once and stored only as a hash — we can’t recover one. Revoke it and mint a new key
in the dashboard or via /v1/keys.