POST /api/v3/account
Field | Description | Example | Type | Required |
---|---|---|---|---|
X-API-SIG | ECDSA Signature, it's the request signing | "0xccf0a141fce2dc5cbbd4f802c52220e9e2ce260e86704d6258603eb346eefe2d4a450005c362b223b2842d087f7065ea5eee0314531adf6a580fce64c25dca81c02" | Y |
Field | Description | Example | Type | Required |
---|---|---|---|---|
exchange | exchange address | "0xbbbbca6a901c926f240b89eacb641d8aec7aeafd" | string | Y |
owner | owner address | "0xB4A70168340C75119523019f79F5Ffd9c60DceC7" | string | Y |
accountId | user account ID | 10010 | integer | Y |
publicKey | PublicKey, The user's public key | {x:0x241707bcc6d7a4ccf10304be248d343a527e85f61b45d721544d027cc1f2fb5f,y:0x302f3a521dbdd1d0eb1944c8323d4ac3b3e9c9201f4aa43a2565054886369d9c} | Public Key | Y |
maxFee | TokenAmount, maximum of fee token | "{tokenId: 0, volume: 1000000}" | Token VolumeV3 | Y |
validUntil | Timestamp for order to become invalid | 1583183141 | integer | Y |
nonce | Nonce of users exchange account that used in off-chain requests. | 1 | integer | Y |
keySeed | KeySeed of users L2 eddsaKey, the L2 key should be generated from this seed, i.e., L2_EDDSA_KEY=eth.sign(keySeed). Otherwise, user may meet error in login loopring DEX | "Sign this message to access Loopring Exchange: 0xbbbbca6a901c926f240b89eacb641d8aec7aeafd with key nonce: 103" | string | N |
counterFactualInfo | (Optional) Counterfactual wallet extra info to verify L1 ecdsa signature. | "{walletFacto ry: 0xABCD, walletOwner: 0xABCD, walletSalt: 1234}" | Counter Factual Info | N |
Field | Description | Example | Type | Required |
---|---|---|---|---|
hash | The order hash identifier set by the user at the time of submission | "0x1d923ca7834dc90484fa2eb611f0f0bc7e741bb107007ebea19ba8caeab4f9d3" | string | Y |
status | Whether the order was successfully submitted or not, please note, that the user may query after a while to get real process status, as most off-chain requests are async processed Allowable : ['received', 'processing', 'processed', 'failed'] | "processing" | string | Y |
isIdempotent | Idempotent of submit order response, submit same order again when order was UNKNOWN or WAIT_FREEZE_BALANCE in relayer, idempotent will be true Allowable : [True, False] | false | boolean | Y |
Field | Description | Example | Type | Required |
---|---|---|---|---|
x | The public keys x part. | "0x241707bcc6 d7a4ccf10304 be248d343a52 7e85f61b45d7 21544d027cc1 f2fb5f" | string | Y |
y | The public keys y part. | "0x302f3a521d bdd1d0eb1944 c8323d4ac3b3 e9c9201f4aa4 3a2565054886 369d9c" | string | Y |