Building on Dreamcash

Building on Dreamcash refers to any integration that interacts with the Hyperliquid API and includes the Dreamcash builder code. This covers custom trading interfaces, bots, and third-party applications.

Builder fee required to earn XP

To earn Season XP, you must set a builder fee (builder.f) of either 0.02% or 0.045%. At 0.045% you earn 1 XP per dollar traded. At 0.02% you earn 0.5 XP per dollar traded. Setting the fee to 0 means no XP will be earned.

Builder address

You'll need this builder address before continuing:

0x4950994884602d1b6c6d96e4fe30f58205c39395

1. Prerequisites

Before starting, make sure:

  • You have a Hyperliquid account
  • You have already funded it with a small amount of USDC
  • You have the Dreamcash app installed

2. Connect Dreamcash to Hyperliquid

  1. Create and fund your Hyperliquid account
  2. Go to https://dreamcash.xyz/connect
  3. Open the Dreamcash app
  4. Import the same wallet used for Hyperliquid

Once connected, Dreamcash will recognize and associate your Hyperliquid trading account.

3. API Endpoint

All trading requests are sent to:

http
POST https://api.hyperliquid.xyz/exchange

Required header:

http
Content-Type: application/json

4. Order Request Schema

A valid order request structure including the required Dreamcash builder block:

json
{
  "action": {
    "type": "order",
    "grouping": "na",
    "orders": [
      {
        "a": 0,
        "b": true,
        "p": "99140",
        "s": "0.00021",
        "r": false,
        "t": {
          "limit": {
            "tif": "Gtc"
          }
        },
        "c": "0x1234567890abcdef1234567890abcdef"
      }
    ],
    "builder": {
      "b": "0x4950994884602d1b6c6d96e4fe30f58205c39395",
      "f": 0
    }
  },
  "nonce": 1764696986349,
  "expiresAfter": 1764697000496,
  "vaultAddress": null,
  "signature": {
    "r": "0xSIGNATURE_R",
    "s": "0xSIGNATURE_S",
    "v": 28
  }
}

Key Values

Field Purpose
a Asset ID (example: 0 = BTC)
b true = buy, false = sell
p Price
s Size
t.limit.tif Time in force (Gtc, Alo, Ioc)
c Optional client order ID
builder.b Dreamcash builder address
builder.f Builder fee — 0 recommended
nonce Millisecond timestamp
signature Valid signature generated by your signing logic
Connect a wallet Back to top