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


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"

Last updated