Events

Loans & Loan Events

Query your loan positions and lifecycle events. All data is scoped to the authenticated wallet.

GET

/api/v1/loans

List your loans. Filter by source (hub/vault/leverage/vesting) and active status.

Auth: Session or API Key

Query Parameters

Param	Type	Description
source	string	`hub`, `vault`, `leverage`, or `vesting`
active	boolean	`true` or `false`
page	number	Page number (default: 1)
limit	number	Items per page (default: 20, max: 100)

Response

{
  "data": [{
    "wallet": "0x...",
    "source": "hub",
    "ecosystem": "0x...",
    "loanId": 1,
    "hubId": 1,
    "token": "0x...",
    "collateralAmount": "1000000000000000000",
    "borrowedAmount": "500000000000000000",
    "fullAmount": "510000000000000000",
    "liquidationTime": 1710000000,
    "isLiquidated": false,
    "active": true,
    "daysCount": 30,
    "expiresAt": "2026-04-15T00:00:00.000Z",
    "creationTime": 1707408000,
    "txHash": "0x..."
  }],
  "pagination": { "total": 5, "page": 1, "limit": 20, "hasMore": false }
}

GET

/api/v1/loans/events

List your loan lifecycle events (created, repaid, extended, etc.).

Auth: Session or API Key

Query Parameters

Param	Type	Description
source	string	Filter by source
action	string	`created`, `repaid`, `extended`, `increased`, `liquidated`, `partial_sell`
page	number	Page number (default: 1)
limit	number	Items per page (default: 20, max: 100)

Response

{
  "data": [{
    "wallet": "0x...",
    "source": "hub",
    "action": "created",
    "loanId": 1,
    "hubId": 1,
    "txHash": "0x...",
    "blockNumber": 12345678,
    "data": "{\"borrowed\":\"500000000000000000\"}",
    "timestamp": "2026-03-20T00:00:00.000Z"
  }],
  "pagination": { "total": 12, "page": 1, "limit": 20, "hasMore": false }
}