---
title: "Provision a Hyperliquid agent wallet"
method: POST
path: "/v1/brokers/hyperliquid/provision"
tags: ["Brokers"]
---

# Provision a Hyperliquid agent wallet

`POST /v1/brokers/hyperliquid/provision`

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/brokers/hyperliquid/provision`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Step 1 of the Hyperliquid two-step connect: generate an agent wallet (PK encrypted at rest), return the agent address and the `approveAgent` action payload the user signs in their master wallet. Auto-grants the `trade` scope. Confirm with POST /v1/brokers/{id}/confirm-approval. Requires `write` scope.

## Request body

- object
  - `master_address` string, required
  - `agent_name` string
  - `is_testnet` boolean

## Response `200`

Agent wallet provisioned + approveAgent payload

- object
  - `success` boolean
  - `data` object
    - `connection_id` string
    - `agent_address` string
    - `master_address` string
    - `approve_payload` object
    - `next_step` string

## Other responses

- `400`: Validation failed

---

[API](https://skmtc.dev/marketintell/apis/marketintell-api.md) · [All operations](https://skmtc.dev/marketintell/apis/marketintell-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marketintell/apis/marketintell-api/revisions/f3ef87afc41f?raw)