AI Agent Integration Guide

import hmac, hashlib, time, os, urllib.parse, requests

API_KEY = os.environ["GAIAEX_API_KEY"]
API_SECRET = os.environ["GAIAEX_API_SECRET"]
BASE = "https://openapi.gaiaex.com"

def fapi_request(method: str, path: str, params: dict | None = None):
    p = dict(params or {})
    p["timestamp"] = int(time.time() * 1000)
    query = urllib.parse.urlencode(p)
    signature = hmac.new(API_SECRET.encode(), query.encode(), hashlib.sha256).hexdigest()
    url = f"{BASE}{path}?{query}&signature={signature}"
    return requests.request(method, url, headers={"X-MBX-APIKEY": API_KEY}).json()

# 1. Verify connectivity & server time
assert requests.get(f"{BASE}/fapi/v1/ping").status_code == 200

# 2. Check account balances (GET /fapi/v2/balance) and open positions (GET /fapi/v2/positionRisk)
balances = fapi_request("GET", "/fapi/v2/balance")
positions = fapi_request("GET", "/fapi/v2/positionRisk", {"symbol": "ETHUSDC"})

usdc_avail = next((float(b["availableBalance"]) for b in balances if b["asset"] == "USDC"), 0.0)

# 3. Place a limit order (POST /fapi/v1/order)
if usdc_avail > 100:
    order = fapi_request("POST", "/fapi/v1/order", {
        "symbol": "ETHUSDC",
        "side": "BUY",
        "type": "LIMIT",
        "quantity": "0.1",
        "price": "3500.00",
        "timeInForce": "GTC",
    })
    print("Placed order:", order)

import asyncio
import websockets
import json

async def ai_agent():
    uri = "wss://openapi.gaiaex.com/ws/market/ETH"
    async with websockets.connect(uri) as ws:
        count = 0
        async for raw in ws:
            msg = json.loads(raw)
            if msg.get("type") == "orderbook":
                bids = msg.get("bids", [])
                best_bid = bids[0][0] if bids else "N/A"
                print(f"ETH best bid: {best_bid}")
                count += 1
                if count >= 5:
                    break

asyncio.run(ai_agent())