---
title: "POST /v2/perp-transfers/hyperliquid/{transfer_id}/submission"
method: POST
path: "/v2/perp-transfers/hyperliquid/{transfer_id}/submission"
tags: ["Perpetuals"]
---

# POST /v2/perp-transfers/hyperliquid/{transfer_id}/submission

`POST /v2/perp-transfers/hyperliquid/{transfer_id}/submission`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/perp-transfers/hyperliquid/{transfer_id}/submission`
- Auth: HTTP bearer

Verifies the owner signature, commits submission-unknown before network I/O, and submits the exact usdClassTransfer action at most once.

## Path parameters

- `transfer_id` string, uuid, required

## Request body

- SubmitHyperliquidInternalTransferRequest
  - `attempt_id` string, uuid, required
  - `signature` string, required

## Response `200`

Definitive or replayed transfer state

- HyperliquidInternalTransfer
  - `app_fee_usdc_atomic` '0', required
  - `attempt_id` string, uuid, required
  - `builder_fee_usdc_atomic` '0', required
  - `direction` 'spot_to_perps' | 'perps_to_spot', required
  - `exact_usdc_atomic` string, required
  - `expected_output_usdc_atomic` string, required
  - `priority_fee_usdc_atomic` '0', required
  - `state` 'signature_required' | 'submission_unknown' | 'completed' | 'rejected', required
  - `total_fee_usdc_atomic` '0', required
  - `transfer_id` string, uuid, required

## Other responses

- `202`: Provider result remains ambiguous
- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `404`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `408`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `409`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `413`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `422`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

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