GET /v1/tier/{wallet} — Wallet Credit Tier (A–E)

GET /v1/tier/ — Returns the credit tier letter (A through E) assigned to a wallet based on its on-chain BlackSwan trust ratio score.

This endpoint returns the credit tier letter assigned to a wallet based on its trust ratio. Tiers range from A (highest) to E (lowest) and are derived from the wallet’s on-chain repayment history. Use this endpoint when you need a simple, categorical signal of creditworthiness — for example, to gate access to financial products or display a trust badge.

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

Request Example

Amoy (default)

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

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

Response — 200 OK

{
  "trustTierScore": "C"
}

trustTierScore · string

The credit tier letter for the wallet. Possible values are A, B, C, D, or E, determined by the wallet’s trust ratio as described in the table below.

Tier Thresholds

The tier is assigned based on the wallet’s trustRatio score (0–10,000). You can retrieve the raw trust ratio using GET /v1/reputation or GET /v1/credit.

Trust Ratio Range	Tier
≥ 9000	A
≥ 8000	B
≥ 7000	C
≥ 6000	D
< 6000	E

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.