Submit Trade Intent

Authorization

ApiKeyAuth

x-api-key<token>

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

In: header

Request Body

application/json

nonce*integerrequired

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

Example: 1758690167820

hl_agent_wallet*stringrequired

Agent wallet address to process the intent

Example: 0x742d35Cc6634C0532925a3b8D489C8A4c40F8C7B

hl_action*objectrequired

Hyperliquid action details

type*enum<string>required

Action type

Available options: order

orders*array<object>required

Orders to place

Array items:

a*integerrequired

Asset index

Example: 0

b*booleanrequired

Buy (true) or sell (false)

p*stringrequired

Limit price

Example: 43250.0

s*stringrequired

Order size

Example: 0.1

r*booleanrequired

Reduce-only flag

t?object

Order type specification

limit?object

tif?enum<string>

Time in force

Available options: AloIocGtc

trigger?object

triggerPx?string

Trigger price

isMarket?boolean

Execute as market order

tpsl?enum<string>

Take profit or stop loss

Available options: tpsl

cloid?string

Client order ID (UUID format)

Example: a3b5b1e0-3e7a-4b6c-9c35-cc8f7a0f7c01

Response Body

`application/json`

curl -X POST "https://api.hypereth.io/v1/trade/intent" \
  -H "Content-Type: application/json" \
  -d '{
    "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"
        }
      ]
    }
  }'

curl -X POST "https://api.hypereth.io/v1/trade/intent" \  -H "Content-Type: application/json" \  -d '{    "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
            }
          }
        ]
      }
    }
  }
}

{
  "error": "Invalid API key",
  "code": 1001,
  "details": {}
}

{
  "error": "Invalid API key",
  "code": 1001,
  "details": {}
}

{
  "error": "Invalid API key",
  "code": 1001,
  "details": {}
}

Submit Trade Intent

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`