API reference
Interactive OpenAPI for Control API /v1 — auth, hosts, and Try It.
Live contract for the Control API (/v1). The interactive viewer below loads from /openapi.yaml — full-bleed Try It, theme-synced with docs.
Hosts
| Role | Value |
|---|---|
| Public testnet | https://api.proxyhubb.com |
| Local | http://localhost:8080 |
Buyer traffic is not on this host — use proxy.proxyhubb.com:8090 (CONNECT / SOCKS5). See Buyer proxy.
Authentication
| Scheme | Header | Use for |
|---|---|---|
| Bearer JWT | Authorization: Bearer <access_token> | Session intents, marketplace, wallet UI flows |
| API key | X-API-Key: phub_… (or Bearer phub_… / pk_…) | Bulk pools, B2B orders:create |
| Gateway | X-Gateway-Auth | Edge → control-plane only (not for apps) |
Mint partner keys with a JWT via POST /v1/bulk/api-keys. Public login is wallet-first (/v1/auth/wallet/*).
Suggested first calls
GET /v1/auth/me— confirm JWTPOST /v1/sessions/intent— rotating Connect tokenGET /v1/listings?country=US— browse supplyPOST /v1/orders→ credentials after escrowPOST /v1/bulk/api-keys/POST /v1/bulk/pools— partner paths
In Scalar, set Auth to Bearer JWT (or API key) before using Try Request. Request/response examples are populated for auth, intents, listings, orders, sandbox-buy, credentials, and bulk pools/keys. Default server should be https://api.proxyhubb.com.
Rate limits
- General: ~100 req/min per user/IP
orders:createkeys: default 20/min- Headers:
X-RateLimit-Limit,X-RateLimit-Remaining
Interactive viewer: