ProxyHubb Docs

B2B sandbox purchase

Partner API keys with orders:create for automated purchase flows.

B2B sandbox purchase

Partner clients buy listings with phub_ keys scoped to orders:create.

Mint a purchase key (JWT)

POST /v1/bulk/api-keys
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "name": "partner-sandbox",
  "scopes": "orders:create"
}

Plaintext key is returned once. Keys with orders:create default to ~20 req/min.

Authenticate

X-API-Key: phub_<hex>

Live purchase

  1. POST /v1/orders — { "listing_id", "bandwidth_gb" }
  2. Fund escrow (pay/solana / wallet)
  3. GET /v1/orders/{id}/credentials

Sandbox mocked buy

Requires PROXYHUB_ALLOW_DEV_ESCROW_ACTIVATE=true on control-api (not for production):

POST /v1/orders/sandbox-buy
X-API-Key: phub_<hex>
Content-Type: application/json

{
  "listing_id": "<uuid>",
  "bandwidth_gb": 1
}