> ## 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/reputation/{wallet} — Wallet Reputation Score

> GET /v1/reputation/{wallet} — Returns repaid loan volume, total loan count, and trust ratio score for any EVM wallet address on BlackSwan.

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.

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

## Request Example

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

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

## Response — 200 OK

```json theme={null}
{
  "repaidVolume": 99,
  "loans": 1,
  "trustRatio": 7700
}
```

<ResponseField name="repaidVolume" type="number">
  Cumulative USD value of all loans the wallet has successfully repaid. A higher value reflects a stronger on-chain repayment history.
</ResponseField>

<ResponseField name="loans" type="number">
  Total number of loans the wallet has taken out across all activity on the specified network.
</ResponseField>

<ResponseField name="trustRatio" type="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](/api/tier) for tier thresholds.
</ResponseField>

## 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.             |