---
title: "Operator update Hyperliquid leverage for an agent position"
method: POST
path: "/trade/{venue}/leverage"
tags: ["Trading"]
---

# Operator update Hyperliquid leverage for an agent position

`POST /trade/{venue}/leverage`

Operator recovery endpoint. Auth deliberately accepts platform operators or tenant admins and must not require an agent JWT, so humans can recover funds when the agent token is expired. Raw signing keys never leave the vault; all recovery actions are audited and idempotency-protected. Builder-perp symbols such as xyz:SPCX are forced to isolated margin and capped at 3x before submitting Hyperliquid's separate updateLeverage action.

## Headers

- `X-Steward-Request-Timestamp` string
- `X-Steward-Request-Expires-At` string
- `X-Steward-Signature` string
- `X-Steward-Signing-Key-Id` string
- `Idempotency-Key` string

## Request body

- object
  - `agentId` string, required
  - `idempotencyKey` string
  - `coin` union, required
    - 'BTC' | 'ETH' | 'BNB' | 'SOL' | 'AVAX' | 'ARB' | 'OP' | 'NEAR' | 'HYPE' | 'ZEC' | 'XMR'
    - string
  - `leverage` integer, required
  - `isCross` boolean

## Response `200`

JSON response

- object
  - `ok` true, required
  - `data` object, required
    - `venue` 'hyperliquid'
    - `walletAddress` string
    - `coin` union
      - 'BTC' | 'ETH' | 'BNB' | 'SOL' | 'AVAX' | 'ARB' | 'OP' | 'NEAR' | 'HYPE' | 'ZEC' | 'XMR'
      - string
    - `leverage` integer
    - `requestedLeverage` integer
    - `isCross` boolean
    - `builderPerp` boolean
    - `result` object

## Other responses

- `400` — JSON response
- `401` — JSON response
- `403` — JSON response
- `404` — JSON response
- `408` — JSON response
- `409` — JSON response
- `502` — JSON response

## Changes

- **2026-08-17** `261a7c8070b2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/steward-fi/apis/steward-api/changes/trade/:venue/leverage/post.md)

---

[API](https://skmtc.dev/steward-fi/apis/steward-api.md) · [All operations](https://skmtc.dev/steward-fi/apis/steward-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/steward-fi/steward-api/revisions/b88b4b97a664/schema)