Skip to main content

​
Endpoint

POST /info

​
Request Body

ParameterTypeDescription
type*stringMust be "ledger"
user*stringUser’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

FieldTypeDescription
timenumberTransaction timestamp (ms)
hashstringTransaction hash
deltaobjectTransaction 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