Venue Management

List Configured Venues

Retrieve all venues configured for your API key with their current status.

GET /v2/account/venues

Headers

Header	Value
`x-api-key`	Your API key

Response

[
  {
    "venue": "hyperliquid",
    "status": "active",
    "wallet_address": "0x5555555555555555555555555555555555555555",
    "model": "programmatic"
  },
  {
    "venue": "aster",
    "status": "active",
    "wallet_address": "0x6666666666666666666666666666666666666666",
    "model": "generate_confirm"
  },
  {
    "venue": "lighter",
    "status": "active",
    "account_address": "0x7777777777777777777777777777777777777777",
    "model": "user_credentials"
  },
  {
    "venue": "paradex",
    "status": "pending_user_action",
    "public_key": "0x...",
    "model": "generate_confirm"
  }
]

Status Values

Status	Description
`active`	Venue is configured and ready for trading
`pending_user_action`	Model 2 venue awaiting UI confirmation (prepare done, confirm pending)
`expired`	Model 1 credentials have expired (auto-renewal may be in progress)
`revoked`	Credentials have been revoked

Python Example

import requests

api_key = "api_..."
headers = {"x-api-key": api_key}

resp = requests.get(
    "https://api.hypereth.io/v2/account/venues",
    headers=headers,
)
for venue in resp.json():
    print(f"{venue['venue']}: {venue['status']} ({venue['model']})")

Delete Venue Credentials

Remove a venue and its credentials from your account.

DELETE /v2/account/venues/{venue}

Path Parameters

Parameter	Description
`venue`	The venue to remove (e.g., `lighter`, `hyperliquid`, `aster`)

Headers

Header	Value
`x-api-key`	Your API key

Response

HTTP 204 No Content on success.

Behavior by Model

Model	Behavior on Delete
Model 1 (Programmatic)	Calls `revokeAgent` via Privy, then deletes stored credentials
Model 2 (Prepare + Confirm)	Deletes stored keypair. User should also revoke in the venue UI
Model 3 (User Credentials)	Deletes stored credentials

For Model 2 venues, deleting the credentials in HyperETH does not automatically remove the API wallet/subkey from the venue. You should also remove it in the venue's web UI.

Python Example

import requests

api_key = "api_..."
headers = {"x-api-key": api_key}

resp = requests.delete(
    "https://api.hypereth.io/v2/account/venues/lighter",
    headers=headers,
)
if resp.status_code == 204:
    print("Venue deleted successfully")

cURL Example

curl -s -o /dev/null -w "%{http_code}" -X DELETE \
  "https://api.hypereth.io/v2/account/venues/lighter" \
  -H "x-api-key: $API_KEY"
# Expected: 204

Venue Management

On this page