Tutorials

1. User Tutorials (Trading & Yield Operations)

1.1 Order Placement Strategies

• Limit Orders: Place orders at a desired price; executed only when the market reaches that price.

• Market Orders: Immediate execution at the best available price; suitable for high-speed trades.

• Stop Orders (Stop-Loss / Take-Profit):

  • Stop-loss: Automatically sell to limit losses if price drops to a predefined level.

  • Take-profit: Automatically sell to lock in gains once the price reaches a target.

1.2 Margin Modes

• Isolated Margin (Cross Margin Disabled): Each position’s margin is isolated; liquidation risk limited to that position.

• Cross Margin (Full Account Collateral): All positions share collateral; maximizes leverage efficiency but increases risk.

• Tutorial: Switching between Isolated and Cross margin modes via the UI before opening positions.

1.3 Liquidity Provision (LP)

• Add Liquidity: Deposit token pairs (e.g., ETH/USDT) into AMM or ALP pools to earn trading fees.

• Remove Liquidity: Withdraw assets and accrued fees at any time.

• Tutorial Example:

  1. Connect wallet → navigate to LP section → select pool → enter amounts → confirm.

  2. On-chain settlement ensures non-custodial asset control.

1.4 Staking $ORANGE

• Stake $ORANGE tokens to earn protocol rewards or participate in governance.

• Tutorial Steps:

  1. Connect wallet → navigate to Staking page → enter amount → confirm transaction.

  2. Track rewards in real-time → claim periodically.

• Smart contract ensures full transparency and non-custodial security.

---

2. Developer Tutorials (API Quick Start)

2.1 API Key Management

• Generate API keys via the OrangeBit Developer Portal.

• Set permissions: read-only, trading, or withdrawal.

• Keep keys confidential; OrangeBit does not store private keys for API operations.

2.2 Authentication & Signing

• REST API:

  • Include API key and HMAC-SHA256 signature of request payload.

  • Example signing snippet (Python):

Python

import hmac, hashlib, time
api_secret = 'YOUR_API_SECRET'
payload = 'timestamp=123456789&order_id=1'
signature = hmac.new(api_secret.encode(), payload.encode(), hashlib.sha256).hexdigest()

• WebSocket API:

  • Connect with API key & signature for real-time subscription to order books, trades, and account updates.

2.3 Order Management

• Create Orders: REST endpoint /order/new

• Cancel Orders: /order/cancel

• Get Order Status: /order/status

• Example: Placing a limit buy:

json

{
  "symbol": "ETH-USDT",
  "side": "BUY",
  "type": "LIMIT",
  "price": "2000",
  "quantity": "0.5"
}

2.4 Real-Time Market Data

• Subscribe to WebSocket channels:

  • Order Book: receive updates in real-time for all trading pairs.

  • Trades: track executed trades.

  • Wallet Balances: monitor account changes.

2.5 Example: Developer Quick Start Workflow

1. Generate API key → configure permissions.

2. Sign requests using API secret → send REST/WebSocket requests.

3. Place test orders in sandbox mode → verify responses.

4. Integrate into trading bots or portfolio management tools.