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.

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

1Create and fund your Hyperliquid account
2Go to https://dreamcash.xyz/connect
3Open the Dreamcash app
4Import 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