Update account EDDSA key

Rate limit: 5 every second

API Overview


HTTP method

POST

Path

/api/v3/account

Summary

Updates the EDDSA key associated with the specified account, making the previous one invalid in the process.

API description


HTTP Header

Field Type Required Description Example
X-API-SIG string Y ECDSA Signature "0xccf0a141fce2dc5cbbd4f802c52220e9
e2ce260e86704d6258603eb346eefe2d
4a450005c362b223b28402d087f7065e
a5eee0314531adf6a580fce64c25dca81c02"

Request parameters

Field Type Required Description Example
exchange string Y exchange address "1"
owner string Y owner address "0xB4A70168340C751195
23019f79F5Ffd9c60Dce
C7"
accountId integer Y user account ID 1
publicKey PublicKey Y The user's public key "{x:0x241707bcc6d7a4c
cf10304be248d343a527
e85f61b45d721544d027
cc1f2fb5f,y:0x302f3a
521dbdd1d0eb1944c832
3d4ac3b3e9c9201f4aa4
3a2565054886369d9c}"
maxFee TokenVolumeV3 Y maximum of fee token "{tokenId: 0, volume: 1000000}"
validUntil integer Y Timestamp for order to become invalid 1583183141
nonce integer Y Nonce of users exchange account that used in off-chain requests. 1
eddsaSignature string N eddsa signature of this request "0xccf0a141fce2dc5cbb
d4f802c52220e9e2ce26
0e86704d6258603eb346
eefe2d4a450005c362b2
23b28402d087f7065ea5
eee0314531adf6a580fc
e64c25dca81c02"
ecdsaSignature string N ecdsa signature of this request "0xeb14773e8a07d19bc4
fe56e36d041dcb002652
f7e92160deaf5e6bf21e
05c7a9eb14773e8a07d1
9bc4fe56e36d041dcb00
2652f7e92160deaf5e6b
f21e05c7a9eb14773e8a
07d19bc4fe56e36d041d
cb002652f7e92160deaf
5e6bf21e05c7a9"
hashApproved string N An approved hash string which was submitted on eth mainnet "0xf7c932351186c3a905
3f313eefa16209c018f7
f1dba8aa8ca7100400f7
c31085"

Request example

HTTP
CURL
POST https://api3.loopring.io/api/v3/account HTTP/1.1
Host: api3.loopring.io
Connection: keep-alive
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en;q=0.9
X-API-SIG: dkkfinfasdf
Content-Type: application/json

{
    "exchange" : "1",
    "owner" : "0xB4A70168340C75119523019f79F5Ffd9c60DceC7",
    "accountId" : 1,
    "publicKey" : {
        "x" : "0x241707bcc6d7a4ccf10304be248d343a527e85f61b45d721544d027cc1f2fb5f",
        "y" : "0x302f3a521dbdd1d0eb1944c8323d4ac3b3e9c9201f4aa43a2565054886369d9c"
    },
    "maxFee" : {
        "tokenId" : 0,
        "volume" : "1000000000000"
    },
    "validUntil" : 1583183141,
    "nonce" : 1,
    "eddsaSignature" : "0xccf0a141fce2dc5cbbd4f802c52220e9e2ce260e86704d6258603eb346eefe2d4a450005c362b223b28402d087f7065ea5eee0314531adf6a580fce64c25dca81c02",
    "ecdsaSignature" : "0xeb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9",
    "hashApproved" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085"
}
curl -X POST -H "X-API-SIG:dkkfinfasdf" -H "Content-Type:application/json" https://api3.loopring.io/api/v3/account -d \
'{
    "exchange" : "1",
    "owner" : "0xB4A70168340C75119523019f79F5Ffd9c60DceC7",
    "accountId" : 1,
    "publicKey" : {
        "x" : "0x241707bcc6d7a4ccf10304be248d343a527e85f61b45d721544d027cc1f2fb5f",
        "y" : "0x302f3a521dbdd1d0eb1944c8323d4ac3b3e9c9201f4aa43a2565054886369d9c"
    },
    "maxFee" : {
        "tokenId" : 0,
        "volume" : "1000000000000"
    },
    "validUntil" : 1583183141,
    "nonce" : 1,
    "eddsaSignature" : "0xccf0a141fce2dc5cbbd4f802c52220e9e2ce260e86704d6258603eb346eefe2d4a450005c362b223b28402d087f7065ea5eee0314531adf6a580fce64c25dca81c02",
    "ecdsaSignature" : "0xeb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9eb14773e8a07d19bc4fe56e36d041dcb002652f7e92160deaf5e6bf21e05c7a9",
    "hashApproved" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085"
}'

Response fields

Field Type Required Description Example
hash string Y The order hash identifier set by the user at the time of submission "0x1d923ca7834dc90484
fa2eb611f0f0bc7e741b
b107007ebea19ba8caea
b4f9d3"
status string Y Whether the order was successfully submitted or not, please note, user may query after a while to get real process status, as most offchain requests are async processed
Allowable : ['received', 'processing', 'processed', 'failed']
"received"
isIdempotent boolean Y 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]
"true"

Response example

{
    "hash" : "0x1d923ca7834dc90484fa2eb611f0f0bc7e741bb107007ebea19ba8caeab4f9d3",
    "status" : "received",
    "isIdempotent" : true
}

Status code

Value Description
100000 Unknown error
100001 Invalid argument
102001 Exchange ID is incorrect
102021 Nonce is invalid
102022 Transfer sender is invalid
102023 Transfer receiver is invalid
102024 Fee token is unsupported
102025 Transfer token isnt consistent with fee token

Model


PublicKey

Describes the users public key which is a point of the selected eclipse curve.

Field Type Required Description Example
x string Y The public keys x part. "0x241707bcc6d7a4ccf1
0304be248d343a527e85
f61b45d721544d027cc1
f2fb5f"
y string Y The public keys y part. "0x302f3a521dbdd1d0eb
1944c8323d4ac3b3e9c9
201f4aa43a2565054886
369d9c"

TokenVolumeV3

Wrapper object used to describe a token associated with a certain quantity.

Field Type Required Description Example
tokenId integer Y The Loopring's token identifier. 0
volume string Y The volume of the token "1000000000000"

results matching ""

    No results matching ""