POST
/
api
/
v1
/
auth
curl --request POST \
  --url https://mainnetapiserverwriter.logx.network/api/v1/auth \
  --header 'Broker-Id: <broker-id>' \
  --header 'Content-Type: application/json' \
  --data '{
  "subaccountId": "1_0x4012AB6a68CD1B2Eb2d0B1DdcE846DBe5d0B4059_1",
  "signingKey": "0xc36502E297E92763a71d167BE335C3c741b011d7",
  "signingSignature": "0xd9f975ac9d1322a83a681b17d6f19f74f5f4c336345abc6185ab15cf5054a4d947d0ec6949f1024e5d35ad2d28165a2844aec43c8f2c5bd9c89f6455d3dae83c1c",
  "ethAddress": "0x4012AB6a68CD1B2Eb2d0B1DdcE846DBe5d0B4059",
  "ethSignature": "0x9406f671d451a78bb7a910e6b271053384bac859a24a3584f34f215ba13aecf22621e8c470cb20e10a5beff787cbe5642cbda6ad0c5f5438d857a1d1261085881b",
  "expiryTs": 1723637411750,
  "nonce": 26,
  "chainId": 42161
}'
{
  "body": {
    "logx_key": "ba87ca738f08414e867b94a7bc773a34",
    "logx_secret": "133029bce12e3139e8720a2d5a18ee849af6e6d315f266276c4ba0262cda1719"
  },
  "message": "Subaccount successfully registered",
  "status": 200
}

Headers

​
Broker-Id
string
required

Unique identifier for the broker.

Body

application/json
​
subaccountId
string

The subaccount ID associated with your address.

Example:

"1_0x4012AB6a68CD1B2Eb2d0B1DdcE846DBe5d0B4059_1"

​
signingKey
string

A randomly generated wallet address used for signing.

Example:

"0xc36502E297E92763a71d167BE335C3c741b011d7"

​
signingSignature
string

The signature generated by signing with the signingKey.

Example:

"0xd9f975ac9d1322a83a681b17d6f19f74f5f4c336345abc6185ab15cf5054a4d947d0ec6949f1024e5d35ad2d28165a2844aec43c8f2c5bd9c89f6455d3dae83c1c"

​
ethAddress
string

Your Ethereum wallet address.

Example:

"0x4012AB6a68CD1B2Eb2d0B1DdcE846DBe5d0B4059"

​
ethSignature
string

The signature generated by signing with the ethAddress.

Example:

"0x9406f671d451a78bb7a910e6b271053384bac859a24a3584f34f215ba13aecf22621e8c470cb20e10a5beff787cbe5642cbda6ad0c5f5438d857a1d1261085881b"

​
expiryTs
integer

The expiration timestamp of the signature in milliseconds. Typically set for 6 days.

Example:

1723637411750

​
nonce
integer

The nonce of the subaccount. This can be fetched using the Nonce API.

Example:

26

​
chainId
integer

The chain ID of the network from which the signing is performed.

Example:

42161

Response

200 - application/json
The subaccount was registered successfully.
​
body
object
​
message
string

Status message of the authentication operation.

Example:

"Subaccount successfully registered"

​
status
integer

HTTP status code of the response.

Example:

200