Account Owner Lookup

Description

Returns account details associated with a wallet address, including the internal accountId, publicKey, Loopring-specific tags, and signature-related fields used for authentication.

This endpoint is commonly used to:

• Confirm a wallet’s registration on the Loopring protocol

• Retrieve the public key components (x and y) needed for off-chain operations

• Access signature seed values like keyNonce and keySeed for signing transactions

---

Endpoint

GET /api/v3/account

---

Request

Field	Type	Description	Example
address	string	(Optional) The wallet's public address. address or accountId is required.	0xbefa...b491
owner	string	(Optional) The unique ID of the user's Loopring DeFi account. accountId or address is required.	0xbefa...b491

⚠️ Either address or owner must be provided — at least one is required to query account owner details.

---

Response

Field	Type	Description	Example
accountId	number	The unique ID of the user's Loopring DeFi account.	302001
owner	string	The wallet address of the account owner.	0xbefa...b491
frozen	boolean	Indicates if the wallet is currently locked.	false
publicKey	object	An object containing the user's public key components (x and y), used for verifying off-chain operations.	[ ... ]
publicKey.x	string (hex)	The x coordinate of the elliptic curve public key, encoded as a hex string.	{x: 0x105b...627}
publicKey.y	string (hex)	The y coordinate of the elliptic curve public key, encoded as a hex string.	{y: 0x2d8e...566}
tags	string	A label describing the context or status of the account (e.g., FirstUpdateAccountPaid).	FirstUpdateAccountPaid
nonce	number	The current nonce of the user's exchange account, used to validate and sequence off-chain requests.	1
keyNonce	number	The nonce associated with the user's current signing key. It helps verify off-chain signatures and prevent replay attacks.	1
keySeed	string	The seed used to generate the user's L2 eddsaKey. Typically derived with L2_EDDSA_KEY = eth.sign(keySeed).	"Sign this message to access Loopring Exchange: 0x0BABA1...A4 with key nonce: 0"