GET /v1/apr/{wallet} — Wallet Annual Percentage Rate

GET /v1/apr/ — Returns the current APR in basis points for any EVM wallet. Divide by 1000 to convert to a human-readable percentage.

This endpoint returns the current annual percentage rate (APR) assigned to a wallet based on its on-chain credit history. The APR is expressed in basis points — divide by 1000 to convert to a human-readable percentage. Use this endpoint when you need to display or apply a wallet’s borrowing rate without fetching the full credit profile.

wallet · string · required

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

network · string

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

Endpoint

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

Request Example

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

Response — 200 OK

{
  "currentApr": 142
}

currentApr · number

The wallet’s current APR expressed in basis points. Divide by 1000 to convert to a percentage.

Understanding basis points: The currentApr value uses basis points rather than a decimal percentage. To convert, divide by 1000. For example, a currentApr of 142 equals 0.142% APR. A value of 1000 would equal 1% APR.

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.