# Read your integration

> Read your integration profile, fee settings, activity, limits and usage.

`GET /v2/integrator/me`

Your integration's profile, fee settings, activity, current limits and usage.

**Authentication:** Required: a **server** [integrator key](https://docs.wagyu.xyz/authentication.md) in `X-Integrator-Key`. A public-client key gets `403`.

This route is not in `openapi.json`. It is documented from Wagyu's key guide; the authentication behaviour below was checked against the live API.

## Response

`200` returns `{ integrator, stats, access }`:

- `integrator` — your profile and fee settings.
- `stats` — activity across all keys of the integration.
- `access` — your current limits and usage. Read your own values here instead of assuming the defaults.

This `access` example comes from Wagyu's engineering docs; the values are illustrative, not yours:

<!-- access (illustrative) -->
```json
{
  "limits": { "requestLimitPerMin": 600, "createLimitPerMin": 30, "maxOpenOrders": 40 },
  "defaults": { "requestLimitPerMin": 600, "createLimitPerMin": 6, "maxOpenOrders": 5 },
  "quoteLimitPerMin": 60,
  "openOrderWindowMinutes": 30,
  "openOrders": 3,
  "keyRequestLimitPerMin": 600,
  "clientIpForwarding": {
    "enabled": true,
    "header": "X-End-User-IP",
    "limits": { "requestLimitPerMin": 600, "createLimitPerMin": 6, "maxOpenOrders": 5 }
  },
  "attribution": { "windowDays": 30, "totalOrders": 10, "attributedOrders": 8, "distinctIps": 6 }
}
```

All applicable limits must allow a request. A zero disables that one limit only.

## Example

<!-- curl -->
```bash
curl 'https://api-beta.wagyu.xyz/v2/integrator/me' \
  -H 'x-integrator-key: wg_YOUR_KEY'
```

Without a key, or with an invalid one, the API answers:

<!-- Response · 401 (checked live) -->
```json
{ "code": "unauthorized", "error": "Authentication required." }
```

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