Skip to main content
POST
/
v1
/
trade
/
intent
Submit Trade Intent
curl --request POST \
  --url https://api.hypereth.io/v1/trade/intent \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "nonce": 1734567890123,
  "hl_agent_wallet": "0x742d35Cc6634C0532925a3b8D489C8A4c40F8C7B",
  "hl_action": {
    "type": "order",
    "orders": [
      {
        "a": 0,
        "b": true,
        "p": "43250.0",
        "s": "0.1",
        "r": false,
        "t": {
          "limit": {
            "tif": "Gtc"
          }
        },
        "cloid": "a3b5b1e0-3e7a-4b6c-9c35-cc8f7a0f7c01"
      }
    ]
  }
}
'
{
  "agg_order_id": "a3b5b1e0-3e7a-4b6c-9c35-cc8f7a0f7c01",
  "intent_hash": "0x7f0f2c1ad3e8b9a5c7d4e2f1b8c9d0e3a6b7c8d9e0f1a2b3c4d5e6f7a8b9c1ad",
  "signer": "0x742d35Cc6634C0532925a3b8D489C8A4c40F8C7B",
  "hl_response": {
    "status": "ok",
    "response": {
      "type": "order",
      "data": {
        "statuses": [
          {
            "resting": {
              "oid": 123456789
            }
          }
        ]
      }
    }
  }
}

Authorizations

​
x-api-key
string
header
required

API key for HyperETH authentication. Obtain via POST /v1/api_key/register endpoint.

Body

application/json

Trade intent submission

​
nonce
integer
required

Order intent nonce, should be unique per agent wallet, timestamp in milliseconds

Example:

1758690167820

​
hl_agent_wallet
string
required

Agent wallet address to process the intent

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b8D489C8A4c40F8C7B"

​
hl_action
object
required

Hyperliquid action details

Response

Trade intent submitted successfully

Trade intent response

​
agg_order_id
string

Unique aggregated order identifier

Example:

"74a29714-a17c-4a97-b782-a1edffe1fe95"

​
intent_hash
string

Intent hash

Example:

"0x96bf2fdf842ae9a277b3cec57b0ad9ad289e09ad629c15adad5569d2e25f3e2a"

​
signer
string

Agent wallet address to process the intent

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b8D489C8A4c40F8C7B"

​
hl_response
object

Intent action response from Hyperliquid