Introduce

1 General Rules

• All Interface response are in JSON format;

• All times and timestamps are UNIX times in milliseconds.

• For GET requests, append parameters to the URL.

• POST requests should be in either application/json or application/x-www-form-urlencoded format, as individually marked for each interface.

• For interfaces that require signature verification, please add APIKEY and APIKEY_SIGN_TYPE_HEADER and signature in the request header.

• Note：there is no close position method,instead of use the method named of "open order" by negative direction with your position.

NOTE：Some interfaces require verification of the API key and the signature of the request data, indicated in the interface documentation by the [**Signature Verification Required**] field. If marked [Yes], the following request headers need to be added]
​
Required request headers:
APIKEY  -- The API key used to call the API (also referred to as api_key in the following)
APIKEY_SIGN_TYPE_HEADER -- the type of signature(1-hmac 2-secp256k1 3-ed25519), just chose the 2.
signature  -- The signature made with the api_secret corresponding to the API key for the request parameters.

2 Apply API Key

APIKEY：

The market maker API is divided into three categories: public queries, private queries, and private operations. For the private category interfaces, authentication with API key is required.

Apply APIKEY URL：

• Testnet: https://zk-test.satori.finance/tradeApi

• Mainnet: zkSync: https://zksync.satori.finance/tradeApi

Apply APIKEY

Step：

1. open the domain with your chrome with the url[Apply APIKEY URL]
2. click [Connect Wallet]，connect your wallet,make sure you have a wallet address.
3. click [Create API]
4. input [API Wallet Name] [API Wallet Address].API Wallet Address is an EVM chain address.
5. then [Next]
6. the app_sercret privkey is the api address privkey.which owner by yourself ,please keep it safe.if you generate a new address as your [API Wallet Address] at the website. the privkey will be show only onece, no one will know it include our platform.
7. click [Authorize]，need a sign by your wallet, let us know that this is operation by yourself.
8. get your [API Key]

Note：

• API Key -- The API key used to call the API, (also referred to as api_key in the following)

• API Wallet Address

• Private Key -- The private key is used for signing, (also referred to as api_secret in the following)