Grant a viewer
PUT/viewers/{viewer}
Lets another wallet read your account: GET /balance, GET /positions and GET /trades. Send no body. The viewer signs with x-crx-address set to your account and x-crx-signer set to its own wallet.
Authentication
x-crx-addressx-crx-tsx-crx-sigx-crx-addressx-crx-signerx-crx-tsx-crx-sig
Parameters
| Name | In | Type | Description |
|---|---|---|---|
viewer required | path | string | The viewer wallet, 0x hex. Not the zero address and not the account wallet. |
Responses
200
The wallet already held a grant.
| Field | Type | Description |
|---|---|---|
account required | string | |
viewer required | string | |
granted_by required | string | Wallet that granted access. |
granted_at required | integerminimum 0 | Unix time in milliseconds. |
201
Viewer granted.
| Field | Type | Description |
|---|---|---|
account required | string | |
viewer required | string | |
granted_by required | string | Wallet that granted access. |
granted_at required | integerminimum 0 | Unix time in milliseconds. |
400
invalid_signature, viewer_invalid.
code invalid_signature viewer_invalid
401
unauthorized: a header is missing or malformed, x-crx-ts is out of range, the call was already used, the signature does not match, or the caller lacks access.
code unauthorized
403
not_whitelisted, viewer_is_maker. viewer_grant_wallet_only: only the account wallet can add a viewer.
code not_whitelisted viewer_grant_wallet_only viewer_is_maker
408
timeout: no answer within 30 seconds.
code timeout
409
viewer_cap: the viewer limit is reached; remove one first.
code viewer_cap
429
rate_limited: retry after Retry-After seconds.
code rate_limited
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Seconds until the next call is accepted. |
ratelimit-limit | integer | Maximum calls in a burst. |
ratelimit-remaining | integer | Calls remaining before the limit. |
ratelimit-reset | integer | Seconds until the full limit is restored. |
ratelimit-refill | integer | Calls restored per minute. |
502
upstream: a chain read failed. Retry shortly.
code upstream
503
viewers_unavailable: viewer data is unavailable. Retry later.
code viewers_unavailable