Balance & Ledger

Check your USDC balance and view transaction history.

Get Balance

GET /api/pool/balance/:wallet

Path Parameters

Parameter	Type	Required	Description
wallet	string	required	Wallet address (0x format)

Response

Response 200 OK

{
  "success": true,
  "data": {
    "wallet_addr": "0x1234...abcd",
    "balance": 1250.00,
    "locked": 300.00,
    "total_deposited": 2000.00,
    "total_withdrawn": 500.00,
    "available": 950.00,
    "max_withdraw": 950.00,
    "on_chain_available": 950.00
  }
}

Response Fields

Field	Description
`balance`	Total USDC balance (including locked)
`locked`	USDC currently locked in pending operations
`available`	USDC available for trading or withdrawal (balance - locked)
`max_withdraw`	Maximum withdrawable amount (min of DB and on-chain available)
`on_chain_available`	On-chain verified available balance (null if chain unavailable)

Transaction Ledger

GET /api/pool/ledger/:wallet

Query Parameters

Parameter	Type	Required	Description
limit	integer	optional	Number of entries (default: 50)
type	string	optional	Filter: `deposit`, `withdraw`, `trade`, `settlement`, `refund`

Response

Response 200 OK

{
  "success": true,
  "data": [
    {
      "id": 234,
      "type": "deposit",
      "amount": 500.00,
      "tx_hash": "0xabc...",
      "chain": "bsc",
      "note": "USDC deposit (on-chain verified)",
      "created_at": "2026-02-25T10:00:00.000Z"
    },
    {
      "id": 235,
      "type": "trade",
      "amount": -100.00,
      "note": "Trade: YES on Market #142",
      "created_at": "2026-02-25T11:30:00.000Z"
    }
  ],
  "count": 2
}

Example

# Check balance
curl https://oddsforge.org/api/pool/balance/0x1234567890abcdef1234567890abcdef12345678

# Transaction history
curl https://oddsforge.org/api/pool/ledger/0x1234567890abcdef1234567890abcdef12345678

# Only deposits
curl "https://oddsforge.org/api/pool/ledger/0x1234...?type=deposit"