Account By Address

The accountByAddress query resolves a wallet address to its accountId, using the on-chain account registry as the authority. It accepts both kinds of address:

A master address resolves to its own accountId.
An agent (API wallet) address resolves to the accountId of the master it is bound to, with isAgent set to true.

Use it to discover your accountId after registration, or to confirm which master an agent wallet signs for before trusting it.

Request

{"type": "accountByAddress", "address": "0xabc...123"}

string

required

Must be "accountByAddress".

string

required

The address to resolve — "0x" followed by 40 hex characters. Case-insensitive.

Response

{
  "type": "accountByAddress",
  "address": "0xabc...123",
  "accountId": "1",
  "isAgent": false,
  "masterId": "0"
}

string

The queried address, echoed back in lowercase.

string

The resolved account ID. "0" means the address is not registered or has no valid binding — treat it as “not found”, not as account zero.

boolean

true when the queried address is an agent wallet, in which case accountId is the master it is bound to. false when the address is a master account itself.

string

When isAgent is true, the master account’s ID — identical to accountId. Otherwise "0".

Interpreting the result

Address supplied	`accountId`	`isAgent`	`masterId`
Master account	Its own ID	`false`	`"0"`
Agent wallet	The bound master’s ID	`true`	Same as `accountId`
Unregistered	`"0"`	`false`	`"0"`

Because an agent resolves to its master, actions signed by an approved agent execute under the master account. See Agent Wallets for the delegation model.

Overview

Market Data

Account

Orders

History

Account By Address

Request

Response

Interpreting the result

​Request

​Response

​Interpreting the result

Request

Response

Interpreting the result