Bitcoin API
for AI Agents

import requests, time, os API_KEY = os.environ["PURPLEFLEA_API_KEY"] BASE_URL = "https://api.purpleflea.com" HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"} def get_btc_balance() -> dict: return requests.get( f"{BASE_URL}/wallet/balance", params={"chain": "btc"}, headers=HEADERS ).json() def verify_balance_on_chain(address: str) -> int: """Cross-check via mempool.space before swapping.""" data = requests.get( f"https://mempool.space/api/address/{address}" ).json() cs = data["chain_stats"] return cs["funded_txo_sum"] - cs["spent_txo_sum"] def swap_btc_to_usdc(btc_amount: float) -> dict: """Swap BTC to USDC on Ethereum via Purple Flea bridge.""" return requests.post( f"{BASE_URL}/wallet/bridge", json={ "from_chain": "btc", "to_chain": "eth", "from_asset": "BTC", "to_asset": "USDC", "amount": str(btc_amount), }, headers=HEADERS ).json() def run_payment_agent(): info = get_btc_balance() address = info["address"] last_sats = verify_balance_on_chain(address) # on-chain truth print(f"Listening on {address} ({last_sats} sats confirmed)") while True: time.sleep(60) current_sats = verify_balance_on_chain(address) if current_sats > last_sats: received_sats = current_sats - last_sats received_btc = received_sats / 1e8 print(f"Received {received_sats} sats ({received_btc:.8f} BTC)") result = swap_btc_to_usdc(received_btc) print(f"Swapped to USDC: {result}") last_sats = current_sats if __name__ == "__main__": run_payment_agent()

# Open a 2x leveraged BTC-USD long ($1000 notional) { "market": "BTC-USD", "side": "buy", "order_type":"market", "size_usd": 1000, "leverage": 2, "margin": "isolated" } # Response { "order_id": "hl_ord_8f3k2p...", "market": "BTC-USD", "side": "buy", "fill_price": "97420.50", "size_btc": "0.01026", "notional_usd": 1000, "leverage": 2, "margin_used_usd": 500, "status": "filled" }

import requests, time, os from collections import deque API_KEY = os.environ["PURPLEFLEA_TRADING_KEY"] BASE_URL = "https://api.purpleflea.com" HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"} MARKET = "BTC-USD" WINDOW = 10 # look-back candles for momentum SIZE_USD = 500 # notional per trade def get_btc_price() -> float: r = requests.get( f"{BASE_URL}/trading/ticker", params={"market": MARKET}, headers=HEADERS ).json() return float(r["mark_price"]) def get_open_position() -> dict | None: r = requests.get( f"{BASE_URL}/trading/positions", params={"market": MARKET}, headers=HEADERS ).json() return r.get("position") def place_order(side: str, size_usd: int, leverage: int = 3): return requests.post( f"{BASE_URL}/trading/order", json={ "market": MARKET, "side": side, "order_type":"market", "size_usd": size_usd, "leverage": leverage, "margin": "isolated", }, headers=HEADERS ).json() def close_position(position: dict): close_side = "sell" if position["side"] == "long" else "buy" return requests.post( f"{BASE_URL}/trading/order", json={ "market": MARKET, "side": close_side, "order_type": "market", "reduce_only":True, }, headers=HEADERS ).json() def run_momentum_bot(): prices = deque(maxlen=WINDOW) position = None print(f"Starting BTC momentum bot on {MARKET}...") while True: price = get_btc_price() prices.append(price) print(f"BTC: ${price:,.2f} history={len(prices)}/{WINDOW}") if len(prices) == WINDOW: momentum = (prices[-1] - prices[0]) / prices[0] position = get_open_position() if momentum > 0.005 and not position: print(f"Momentum +{momentum:.3%} — going LONG") place_order("buy", SIZE_USD) elif momentum < -0.005 and not position: print(f"Momentum {momentum:.3%} — going SHORT") place_order("sell", SIZE_USD) elif position and abs(momentum) < 0.001: print("Momentum faded — closing position") close_position(position) time.sleep(300) # 5-min candles if __name__ == "__main__": run_momentum_bot()