Ledger

Endpoint

POST /info

Request Body

Parameter	Type	Description
type*	string	Must be "ledger"
user*	string	User’s wallet address (case-insensitive), e.g., "0x1234567890abcdef..."

Response

[
  {
    "time": 1701234567890,
    "hash": "0x1234abcd...",
    "delta": {
      "type": "trade",
      "coin": "BTC",
      "side": "B",
      "px": "50000.00",
      "sz": "0.1",
      "fee": "2.50"
    }
  },
  {
    "time": 1701230000000,
    "hash": "0x5678efgh...",
    "delta": {
      "coin": "USDC",
      "type": "deposit",
      "usdc": "10000.00",
      "szi": "0"
    }
  }
]

Response Fields

Field	Type	Description
time	number	Transaction timestamp (ms)
hash	string	Transaction hash
delta	object	Transaction details (varies by type)

Example Request

curl -X POST https://api.notional.xyz/info \
  -H "Content-Type: application/json" \
  -d '{
    "type": "ledger",
    "user": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  }'

Error Responses

{
  "error": "Missing 'user' parameter for ledger"
}

HTTP Status: 400 Bad Request

Notes

• Entries returned in reverse chronological order (newest first)
• Transaction types: "trade", "deposit", "withdrawal", "funding", "interest", "liquidation"
• Negative values indicate debits, positive values indicate credits