GET /v1/reputation/{wallet} — Wallet Reputation Score

This endpoint returns the core reputation metrics for a wallet — the total volume it has repaid, the number of loans it has taken, and its overall trust ratio. Use it when you need a focused, lightweight view of an address’s repayment track record without the full credit profile.

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/reputation/{wallet}

Request Example

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

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

Response — 200 OK

{
  "repaidVolume": 99,
  "loans": 1,
  "trustRatio": 7700
}

number

Cumulative USD value of all loans the wallet has successfully repaid. A higher value reflects a stronger on-chain repayment history.

number

Total number of loans the wallet has taken out across all activity on the specified network.

number

Trust score for the wallet, ranging from 0 to 10,000. This value directly determines the wallet’s credit tier and APR. See GET /v1/tier for tier thresholds.

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