---
title: "Operator withdraw venue funds for an agent"
method: POST
path: "/v1/trade/{venue}/withdraw"
tags: ["Trading"]
---

# Operator withdraw venue funds for an agent

`POST /v1/trade/{venue}/withdraw`

## Request

- Base URL: `http://localhost:3200`
- URL: `http://localhost:3200/v1/trade/{venue}/withdraw`
- Auth: one of:
  - API key in header `X-Steward-Platform-Key`
  - API key in header `X-Steward-API-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/steward-fi/apis/steward-api/docs/v1/trade/:venue/withdraw/post.ts> (a function with typed inputs; its response is checked against the schema)

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. Withdrawals must pass the approved-addresses policy gate before signing; if amount is omitted, the route reads the venue withdrawable balance and fails closed when unavailable.

## 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
  - `destination` string, required
  - `amount` union
    - string
    - number

## Response `200`

JSON response

- object
  - `ok` true, required
  - `data` object, required
    - `venue` 'hyperliquid'
    - `walletAddress` string
    - `destination` string
    - `amount` union
      - string
      - number
    - `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

[Operation history](https://skmtc.dev/steward-fi/apis/steward-api/changes/v1/trade/:venue/withdraw/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.dev/steward-fi/apis/steward-api/revisions/b88b4b97a664?raw)