Read your integration

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

Authentication: Required: a server integrator key 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:

{
  "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 '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:

{ "code": "unauthorized", "error": "Authentication required." }