# API

#### **Placing Orders**

API traders can execute trades via Hyperliquid [exchange](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order) 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>&#x20;

(Note: Addition of `cloid` is not required. Only builder code is required.)&#x20;

Based builder wallet:

```
0x1924b8561eeF20e70Ede628A296175D358BE80e5
```

*Sample perp order:*

```markup
{
  "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>&#x20;

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hyena.trade/trading/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.