Skip to main content

​
Wallets

​
GET /api/binance/wallets

List Binance wallets for the current user’s accounts. Example request 
curl https://api.hyperoru.com/api/binance/wallets
Example response 
[
  { "account_id": 1, "has_api_key": true, "balance": 8000.0 }
]

​
All wallets

​
GET /api/binance/wallets/all

List all Binance wallets across all users. Example request 
curl https://api.hyperoru.com/api/binance/wallets/all
Example response 
[
  { "account_id": 1, "has_api_key": true }
]

​
Account snapshot

​
GET /api/binance/account-snapshot

Get a Binance account snapshot including balances and positions. Example request 
curl https://api.hyperoru.com/api/binance/account-snapshot
Example response 
{
  "total_balance": 8000.0,
  "unrealized_pnl": 120.0,
  "positions": [
    { "symbol": "BTCUSDT", "side": "long", "size": 0.02 }
  ]
}

​
Setup

​
POST /api/binance/accounts//setup

Configure Binance API keys for an account.
​
account_id
integer
required
Account ID.
​
api_key
string
required
Binance API key.
​
api_secret
string
required
Binance API secret.
Example request 
curl -X POST https://api.hyperoru.com/api/binance/accounts/1/setup \
  -H "Content-Type: application/json" \
  -d '{"api_key": "abc...", "api_secret": "xyz..."}'
Example response 
{
  "status": "ok"
}

​
Config

​
GET /api/binance/accounts//config

Get Binance configuration for an account.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/binance/accounts/1/config
Example response 
{
  "account_id": 1,
  "has_api_key": true,
  "leverage": 5,
  "margin_type": "cross"
}

​
Balance

​
GET /api/binance/accounts//balance

Get account balance on Binance.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/binance/accounts/1/balance
Example response 
{
  "total_balance": 8000.0,
  "available_balance": 5500.0,
  "margin_balance": 2500.0
}

​
Positions

​
GET /api/binance/accounts//positions

List positions for a specific account on Binance.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/binance/accounts/1/positions
Example response 
[
  { "symbol": "BTCUSDT", "side": "long", "size": 0.02, "entry_price": 67500.0, "unrealized_pnl": 50.0 }
]

​
Place order

​
POST /api/binance/accounts//order

Place an order on Binance.
​
account_id
integer
required
Account ID.
​
symbol
string
required
Trading pair (e.g. BTCUSDT).
​
side
string
required
BUY or SELL.
​
type
string
required
Order type: MARKET or LIMIT.
​
quantity
number
required
Order quantity.
​
price
number
Limit price. Required for LIMIT orders.
Example request 
curl -X POST https://api.hyperoru.com/api/binance/accounts/1/order \
  -H "Content-Type: application/json" \
  -d '{"symbol": "BTCUSDT", "side": "BUY", "type": "MARKET", "quantity": 0.01}'
Example response 
{
  "order_id": "bn-order-001",
  "status": "FILLED",
  "filled_price": 68500.0
}

​
Close position

​
POST /api/binance/accounts//close-position

Close an open position on Binance.
​
account_id
integer
required
Account ID.
​
symbol
string
required
Symbol to close.
Example request 
curl -X POST https://api.hyperoru.com/api/binance/accounts/1/close-position \
  -H "Content-Type: application/json" \
  -d '{"symbol": "BTCUSDT"}'
Example response 
{
  "status": "ok",
  "realized_pnl": 150.0
}

​
Delete wallet

​
DELETE /api/binance/accounts//wallet

Remove Binance API credentials for an account.
​
account_id
integer
required
Account ID.
Example request 
curl -X DELETE https://api.hyperoru.com/api/binance/accounts/1/wallet
Example response 
{
  "status": "ok"
}

​
Account summary

​
GET /api/binance/accounts//summary

Get a trading summary for the Binance account.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/binance/accounts/1/summary
Example response 
{
  "total_trades": 30,
  "total_volume": 85000.0,
  "total_pnl": 1200.0
}

​
Rate limit

​
GET /api/binance/accounts//rate-limit

Check Binance API rate limit status.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/binance/accounts/1/rate-limit
Example response 
{
  "weight_used": 450,
  "weight_limit": 1200,
  "orders_used": 5,
  "orders_limit": 10
}

​
Trading stats

​
GET /api/binance/accounts//trading-stats

Get trading statistics for the account on Binance.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/binance/accounts/1/trading-stats
Example response 
{
  "total_trades": 30,
  "win_rate": 0.60,
  "total_pnl": 1200.0
}

​
Daily quota

​
GET /api/binance/accounts//daily-quota

Check the daily trading quota usage.
​
account_id
integer
required
Account ID.
Example request 
curl https://api.hyperoru.com/api/binance/accounts/1/daily-quota
Example response 
{
  "trades_today": 5,
  "trades_limit": 50,
  "volume_today": 25000.0
}

​
Confirm limited binding

​
POST /api/binance/accounts//confirm-limited-binding

Confirm a limited API key binding for restricted access.
​
account_id
integer
required
Account ID.
Example request 
curl -X POST https://api.hyperoru.com/api/binance/accounts/1/confirm-limited-binding
Example response 
{
  "status": "ok",
  "binding_type": "limited"
}

​
Price

​
GET /api/binance/price/

Get the current price from Binance for a symbol.
​
symbol
string
required
Symbol (e.g. BTC).
Example request 
curl https://api.hyperoru.com/api/binance/price/BTC
Example response 
{
  "symbol": "BTC",
  "price": 68500.25
}

​
Check rebate eligibility

​
POST /api/binance/check-rebate-eligibility

Check if the account is eligible for Binance fee rebates. Example request 
curl -X POST https://api.hyperoru.com/api/binance/check-rebate-eligibility
Example response 
{
  "eligible": true,
  "rebate_pct": 10
}

​
Available symbols

​
GET /api/binance/symbols/available

List all tradable symbols on Binance Futures. Example request 
curl https://api.hyperoru.com/api/binance/symbols/available
Example response 
{
  "symbols": ["BTCUSDT", "ETHUSDT", "SOLUSDT", "ARBUSDT"]
}

​
Watchlist

​
GET /api/binance/symbols/watchlist

​
PUT /api/binance/symbols/watchlist

Get or update the Binance symbol watchlist. Example request (PUT) 
curl -X PUT https://api.hyperoru.com/api/binance/symbols/watchlist \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["BTCUSDT", "ETHUSDT"]}'
Example response 
{
  "symbols": ["BTCUSDT", "ETHUSDT"]
}