GET /v1/history/{wallet} — On-Chain Loan History

This endpoint returns the complete loan performance history for a wallet — including total loans taken, how many were repaid successfully, and how many resulted in a default. Use it when you need to audit a wallet’s track record or display a repayment scorecard to users.

string

required

The EVM wallet address to query (e.g. 0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4).

string

The network to query. Accepted values: amoy (default) or sepolia.

Endpoint

GET https://api.blackswanfinance.xyz/v1/history/{wallet}

Request Example

curl https://api.blackswanfinance.xyz/v1/history/0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4

curl "https://api.blackswanfinance.xyz/v1/history/0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4?network=sepolia"

Response — 200 OK

{
  "totalLoans": 1,
  "successfulLoans": 1,
  "defaults": 0
}

number

The total number of loans the wallet has taken out on the specified network, regardless of outcome.

number

The number of loans the wallet has fully repaid without defaulting. A value equal to totalLoans indicates a perfect repayment record.

number

The number of loans that resulted in a default. A value of 0 indicates the wallet has never defaulted.

Show How defaults affect credit

Each default reduces the wallet’s trustRatio, which in turn raises its currentApr and can lower its credit tier. Repeated defaults may move a wallet from tier C down to tier D or E. You can inspect the current trust ratio and tier using GET /v1/credit.

Error Codes

Status Code	Meaning
`400`	Invalid wallet address — the address is malformed or not a valid EVM address.
`500`	Server error — an unexpected error occurred on the BlackSwan API.

​Endpoint

​Request Example

​Response — 200 OK

​Error Codes

Endpoint

Request Example

Response — 200 OK

Error Codes