Build an agent

import os, time, requests
BASE = "https://api.perpsfund.com/v1"KEY = os.environ["PERPSFUND_API_KEY"]          # sandbox key, from an env varH = {"X-API-Key": KEY, "Content-Type": "application/json"}
def get(path):  return requests.get(BASE + path, headers=H).json()def post(path, body=None): return requests.post(BASE + path, headers=H, json=body or {}).json()
post("/sandbox/reset")                          # start from a clean paper accountacct = get("/sandbox/account")["account"]print("equity:", acct["equity"])
price = get("/sandbox/prices?symbol=BTC")["price"]stop = round(price * 0.98, 2)                    # a 2% protective stop below entry
# --- your decision goes here: what, which side, how big ---res = post("/sandbox/orders", {    "symbol": "BTC", "side": "long", "size": 0.01,    "leverage": 5, "stopLossPrice": stop,})if not res.get("ok"):    print("order rejected:", res.get("error"), res.get("reason"))else:    print("filled at:", res["fill"]["price"])
# Poll until the position is gone (the stop closed it). Note this read is not only OBSERVING:# trigger levels are evaluated on reads, so polling is what fires your stop. Stop polling and# nothing enforces it until you come back. See "Triggers fire on touch" in Trading.while True:    positions = get("/sandbox/positions")["positions"]    if not any(p["symbol"] == "BTC" for p in positions):        print("position closed")        break    time.sleep(5)                                # poll a few seconds apart - reads are a warm cache
# why it closed: "stop_loss", "take_profit", or "market" (you, a flip, or a liquidation)last = get("/sandbox/trades")["trades"][0]print("closed by:", last["orderType"], "at", last["exitPrice"], "pnl", last["realizedPnL"])

import os, requests
_UNSET = object()          # so "clear this level" (None) is distinguishable from "leave it alone"
class PerpsFundError(RuntimeError):    """A rejection from the API. `.code` is the stable machine code, e.g. "bad_symbol"."""    def __init__(self, status, code, reason=""):        super().__init__(f"{status} {code}{': ' + reason if reason else ''}")        self.status, self.code, self.reason = status, code, reason
class PerpsFund:    def __init__(self, key=None, base="https://api.perpsfund.com/v1"):        self.base = base        self.h = {"X-API-Key": key or os.environ["PERPSFUND_API_KEY"],                  "Content-Type": "application/json"}
    def _request(self, method, path, body=None):        r = requests.request(method, self.base + path, headers=self.h,                             json=body, timeout=15)        try:            data = r.json()        except ValueError:            # Not JSON. You are not talking to the API. A proxy, a captive portal or an            # edge security challenge is answering instead. Never parse on; say so.            raise PerpsFundError(r.status_code, "non_json_response",                                 f"expected JSON, got {r.headers.get('content-type')!r}")        if not r.ok:            raise PerpsFundError(r.status_code, data.get("error", "unknown"), data.get("reason", ""))        if "error" in data:                      # belt and braces: an error body with a 2xx            raise PerpsFundError(r.status_code, data["error"], data.get("reason", ""))        return data
    def _get(self, path):             return self._request("GET", path)    def _post(self, path, body=None): return self._request("POST", path, body or {})
    # reads    def account(self):        return self._get("/sandbox/account")["account"]    def positions(self):      return self._get("/sandbox/positions")["positions"]    def markets(self):        return self._get("/sandbox/markets")["markets"]    def price(self, symbol):  return self._get(f"/sandbox/prices?symbol={symbol}")["price"]
    # actions    def order(self, symbol, side, size, **opts):        return self._post("/sandbox/orders", {"symbol": symbol, "side": side, "size": size, **opts})    def close(self, symbol, pct=100):        return self._post("/sandbox/positions/close", {"symbol": symbol, "pct": pct})    def set_tpsl(self, symbol, take_profit=_UNSET, stop_loss=_UNSET):        # Only send the levels you named. Sending null CLEARS a level, so passing one and        # defaulting the other would silently wipe the one you left out.        body = {"symbol": symbol}        if take_profit is not _UNSET: body["takeProfitPrice"] = take_profit        if stop_loss   is not _UNSET: body["stopLossPrice"]   = stop_loss        return self._post("/sandbox/positions/tpsl", body)    def reset(self):          return self._post("/sandbox/reset")