API

Placing Orders

API traders can execute trades via Hyperliquid exchange endpoints with Based builder code and client id.

In order to successfully track trades that happen for each wallet that trades on HyENA, HyENA is implementing the use of Builder Code to scope down the number of wallets to track trades for.

Simply, approve a minimal amount of builder fee to builder code 0x1924b8561eeF20e70Ede628A296175D358BE80e5 and add 0 builder fee with the builder code in each order.

This effectively allows HyENA to track trades that qualify for Ethena Points. Makers who do not apply usage of builder code may not qualify for incentives.

For full clarity, applying the builder fee code to API orders will not charge additional fees, and are merely for tracking purposes. Based API doc: https://basedapp.gitbook.io/docs/developers/api-traders

(Note: Addition of cloid is not required. Only builder code is required.)

Based builder wallet:

0x1924b8561eeF20e70Ede628A296175D358BE80e5

Sample perp order:

{
  "action": {
    "type": "order",
    "orders": [
      {
        "a": 0,
        "b": true,
        "p": "111951",
        "s": "0.0012",
        "r": false,
        "t": {
          "limit": {
            "tif": "Gtc"
          }
        },
        "c": "0xba5ed113124c5008ba5ed10000ba5ed1"
      }
    ],
    "grouping": "na",
    "builder": {
      "b": "0x1924b8561eef20e70ede628a296175d358be80e5",
      "f": 0
    }
  },
  "nonce": ..,
  "signature": {
    ...
  }
}

Modifying Orders

modify function calls do not allow for builder config. Only OrderRequests require builder config settings. After an order is placed, any future modifications or adjustments will apply the same builder code settings.

---

API Limits

HyENA API limits tracks Hyperliquid’s API limits. Additional information on Hyperliquid’s API limits: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/rate-limits-and-user-limits