> For the complete documentation index, see [llms.txt](https://predictbase.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://predictbase.gitbook.io/docs/developer/endpoints/read-users.md).

# Read Users

These endpoints provide **public, read-only access** to PredictBase users data.

* **No authentication required**
* **Rate-limited**
* User data may be **delayed by up to \~2 seconds**

***

### Get User

Returns **aggregated account-level statistics** for a PredictBase user such as balance, volume, revenue.

**Endpoint**

```http
GET /get_user/{user}
```

**Full URL**

```
https://api.predictbase.app/get_user/{user}
```

**Authentication**

* None (rate-limited)

#### Response Example

The response represents **one PredictBase user account**.

```json
{
  "id": "0x2d70267a862e9dee895b53d822b898d3e089d937",
  "balance": "52742708363",
  "isAdmin": true,
  "isOperator": false,
  "volume": "992282803006",
  "revenue": "1206386581",
  "betCount": "598",
  "profit": "5553031528869",
  "marketCount": "884",
  "available": 52742.708363
}

```

***

### Field Descriptions

| Field         | Description                                              |
| ------------- | -------------------------------------------------------- |
| `id`          | User wallet address                                      |
| `balance`     | Total PredictBase USDC balance (1e6 precision)           |
| `available`   | Available USDC balance                                   |
| `isAdmin`     | Whether the user has admin privileges                    |
| `isOperator`  | Whether the user has operator privileges                 |
| `volume`      | Total trading volume (1e6 precision)                     |
| `revenue`     | Total platform revenue generated by user (1e6 precision) |
| `betCount`    | Total number of bets placed                              |
| `marketCount` | Total number of markets created                          |
| `profit`      | Net user profit (1e6 precision)                          |

***

#### Data Notes

* **USDC values** use **1e6 precision** (Example: `"550000"` = 0.55 USDC)
* Timestamps are **Unix seconds**
