> ## Documentation Index
> Fetch the complete documentation index at: https://blackswan-23965643.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

> GET /v1/tier/{wallet} — 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.

<ParamField path="wallet" type="string" required>
  The EVM wallet address to query (e.g. `0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4`).
</ParamField>

<ParamField query="network" type="string">
  The network to query. Accepted values: `amoy` (default) or `sepolia`.
</ParamField>

## Endpoint

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

## Request Example

<CodeGroup>
  ```bash Amoy (default) theme={null}
  curl https://api.blackswanfinance.xyz/v1/tier/0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4
  ```

  ```bash Sepolia theme={null}
  curl "https://api.blackswanfinance.xyz/v1/tier/0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4?network=sepolia"
  ```
</CodeGroup>

## Response — 200 OK

```json theme={null}
{
  "trustTierScore": "C"
}
```

<ResponseField name="trustTierScore" type="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.
</ResponseField>

## 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](/api/reputation) or [GET /v1/credit](/api/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.             |