Python SDK

pip install py-blink-client

git clone https://github.com/BlinkExchange/py-blink-client
cd py-blink-client
pip install -e .

from py_blink_client import ClobClient

# Public data only (no auth needed)
client = ClobClient(host="https://api.blink15.com")

# Trading (requires wallet private key)
client = ClobClient(
    host="https://api.blink15.com",
    key="0xYOUR_PRIVATE_KEY",
)

# Create API credentials (one-time — cached on the client)
creds = client.create_or_derive_api_creds()
print(f"API Key: {creds.api_key}")

# After create_or_derive_api_creds(), all calls use HMAC auth
orders = client.get_orders()              # authenticated
client.create_and_post_order(...)         # authenticated
client.cancel(...)                        # authenticated

from py_blink_client import BlinkApiError, BlinkAuthError

try:
    order = client.create_and_post_order(args)
except BlinkAuthError as e:
    print(f"Auth failed: {e}")  # expired or invalid credentials
except BlinkApiError as e:
    print(f"API error {e.status_code}: {e.response_body}")

# Mint 100 USDC
result = client.claim_faucet("0xYourWalletAddress")
print(f"TX: {result['tx_hash']}")

# Gas-free USDC approval
client.relay_permit(owner, spender, value, deadline, v, r, s)

# Sponsor ETH for CTF token approval
client.prefund_ctf_approval("0xYourWalletAddress")