# Get an address’s points

> Read an address points balance

`GET /v2/points/{address}`

Read an address points balance.

**Authentication:** None. This route is public.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `address` | path | string | Yes | Address whose points balance to read. |

## Response

`200` returns an object with:

- `address` · string · **required**
- `volumeUsd` · number · **required**
- `eligibleOrderVolumeUsd` · number · **required**
- `bonusVolumeUsd` · number · **required**
- `wagyu` · number · **required**
- `rank` · number or null · **required**
- `tradeCount` · number · **required**
- `lastOrderAt` · string or null · **required**
- `formula` · object · **required**
  - `pointsPerUsd` · number · **required**
  - `label` · string · **required**

Errors use the [standard error envelope](https://docs.wagyu.xyz/actions-and-retries.md#the-error-envelope): branch on `code`, never on the message.

## Example

<!-- curl -->
```bash
curl 'https://api-beta.wagyu.xyz/v2/points/<address>'
```

<!-- JavaScript -->
```javascript
const res = await fetch('https://api-beta.wagyu.xyz/v2/points/<address>'
);
const data = await res.json();
```

<!-- Python -->
```python
import requests

res = requests.get('https://api-beta.wagyu.xyz/v2/points/<address>', timeout=30)
data = res.json()
```

_No response is captured for this route: it needs a real order. The response fields above come from the live contract._

---
Source: https://docs.wagyu.xyz/api-reference/get-points · Built from the live Wagyu API on 2026-11-04.