revokeAgent: Remove an Authorized API Wallet

The revokeAgent action immediately invalidates a previously authorized agent wallet. Once revoked, the agent can no longer submit orders, cancellations, or any other signed operations on behalf of your master account. The quota slot previously occupied by the agent is freed and can be reused. Only the master account that originally approved the agent can revoke it. To view all currently active agents for your account, query userAgents via POST /info.

Revocation takes effect immediately. Any in-flight requests signed by the agent that have not yet been processed by the exchange may still be accepted if they arrive before the revocation is recorded.

Endpoint

POST https://dev.upsidemax.xyz/exchange

Request

All requests must include an ECDSA signature and a millisecond-precision nonce. This request must be signed by the master account.

{
  "action": {
    "type": "revokeAgent",
    "agentAddress": "0xabc0000000000000000000000000000000000001"
  },
  "signature": { "r": "0x...", "s": "0x...", "v": 28 },
  "nonce": 1778859600000
}

Action fields

string

required

Fixed value: "revokeAgent".

string

required

The Ethereum address of the agent wallet to revoke. Must match an agent previously approved by your master account.

Response

Success

{
  "status": "ok",
  "response": {
    "type": "revokeAgent",
    "data": { "agentAddress": "0xabc0000000000000000000000000000000000001" }
  }
}

Response fields

string

The address of the agent that was revoked, echoed back for confirmation.

Error reference

Rejections return status: "ok" with an errorCode and errorMessage in data.

Cause	Description
Agent not found	No agent with the given address is registered under your master account.
Not owned by signer	The agent exists but was approved by a different master account; you cannot revoke it.

To authorize a new agent after revoking one, use approveAgent.

Overview

Account

Orders

Margin & Leverage

Conditional Orders

Collateral Transfers

Fee Settings

API Wallet

revokeAgent: Remove an Authorized API Wallet

Endpoint

Request

Action fields

Response

Success

Response fields

Error reference

​Endpoint

​Request

​Action fields

​Response

​Success

​Response fields

​Error reference

Endpoint

Request

Action fields

Response

Success

Response fields

Error reference