Skip to Content

Connecting to Aster DEX

Aster DEX connects to JetScalp not with an “API Key + Secret Key” pair but through an API wallet (Agent Wallet) — a trading key that JetScalp creates itself:

  1. JetScalp creates its own trading key (an agent).
  2. Your wallet signs an approval for that key once, in the browser.
  3. From then on, JetScalp signs orders with that key on behalf of your wallet.

Important: JetScalp never asks for your wallet’s seed phrase or private key — the connection settings have no fields for them. If someone asks you to enter a seed phrase “to connect JetScalp”, it is a scam.

1.Prepare your wallet

Install a Web3 browser-extension wallet that your Aster DEX account is linked to, such as MetaMask or Rabby.

Select the exact account that holds your funds on Aster DEX in the wallet: JetScalp trades and shows the balance of the wallet that signs the approval.

2.Add the connection in JetScalp

Open Settings Settings → Connections, click Add connection below the connection list and click the tile Aster DEX. The connection appears in the list, and its settings appear on the right.

Fill in the connection settings:

FieldValue
NameThe connection name in the list. By default it is the exchange or broker name; you can change it.
ProxyA proxy from the list or None. See Proxy settings.

Aster DEX has two markets, so the connection settings have two sections — Spot and Futures, each with its own switch and state. Turn off the section of a market you do not trade: JetScalp will not connect to it, and the section's fields are kept.

Fill in the fields in each section:

Spot:

FieldValue
WalletThe address of the linked wallet. It is filled in automatically once the approval is signed (step 3) and cannot be typed in. Until a wallet is linked, the field reads "Not linked".

Futures:

FieldValue
WalletThe same for futures: the wallet is linked in this section separately.

The Wallet field has two buttons on the right:

  • Link — opens a page in your browser where the wallet signs an approval for the terminal’s key;
  • Unlink — unlinks the wallet: JetScalp forgets it and its own trading key.

Steps:

  1. Click Link in the section’s Wallet field.
  2. JetScalp opens a signing page in your default browser and copies its link to the clipboard. If your wallet is installed in a different browser, paste the link there.
  3. On the page, choose your wallet and allow the page to access your account.
  4. The signature is accepted on BNB Smart Chain, Ethereum and Arbitrum One. If your wallet is on another network, the page offers to switch — confirm the switch in your wallet.
  5. Sign the approvals in your wallet:
    • in the Futures section — one: “Approve the terminal trading key ‘js-fut-…’ (no withdrawals) with a JetScalp futures fee of up to 0.01% per order”;
    • in the Spot section — two in a row: “Approve the terminal trading key ‘js-spot-…’ (no withdrawals) with a JetScalp futures fee of up to 0.01% per order” and “Approve the JetScalp spot fee of up to 0.01% per order”.
  6. Once Aster DEX accepts the approvals, the page shows “Done: wallet … is connected to the terminal. You can close this tab.”, the wallet address appears in the Wallet field, and “Wallet linked.” appears under it. If the connection is already on, JetScalp reconnects it with the new key right away.

While JetScalp is waiting for the signature, the Link button reads Cancel — click it or Cancel connection on the page to stop waiting. If no signature arrives within 5 minutes, linking is canceled — start it again.

What the trading key approval contains:

  • the address of the trading key created by JetScalp;
  • permissions: spot and futures trading — yes, withdrawals — no;
  • the key’s lifetime — 1 year, after which you link the wallet again;
  • the JetScalp builder address and the cap on its fee (0.0001, that is 0.01%): the builder fee cannot exceed this cap.

The Spot and Futures sections have separate trading keys: link the wallet in each of them — or turn off the section of a market you do not trade. Each connection has its own key name: js-fut- or js-spot- followed by eight random characters. Linking again in the same connection keeps the name and replaces only its own key, so the same wallet can also be linked in another connection or terminal. The trading key is stored encrypted in the JetScalp settings.

The JetScalp fee

JetScalp adds a 0.01% builder fee on volume to every order on Aster DEX — both futures and spot. Aster DEX charges such a fee only after the wallet owner signs an approval with its cap: for futures the cap is part of the trading key approval, for spot it is the separate second signature from step 3. The cap is 0.01%: JetScalp cannot charge more. Without this approval Aster DEX would reject JetScalp’s orders, so a section does not connect without it.

4.Check the position mode (for futures)

JetScalp supports an Aster DEX futures account only in One-way Mode.

If Hedge Mode is enabled on the account, the Futures section does not connect and JetScalp shows this message:

Aster DEX Futures: the account is in Hedge Mode. JetScalp supports only One-way Mode — switch the position mode in the Aster settings. Connection stopped.

Switch the mode in the trading settings on the Aster DEX website and connect again. The mode applies to all symbols of the account at once (Aster API ).

The position mode is a setting of your Aster DEX account; JetScalp does not change it.

5.Turn on the connection and check

Link the wallet in both sections (or turn off the one you do not need), then turn the connection on.

Turn the connection on with the switch on the right of its row in the list. The state appears under the connection name: first connecting…, then connected. If the connection fails, the error text appears there — the full text is shown in the tooltip and in the header of the connection settings. For all states, see Connections.

Check that:

  • Aster DEX is connected.
  • The account balance is shown.
  • Open positions are shown.
  • Orders are placed and canceled.

If the connection does not work

Wallet not linked

The message “The wallet for Aster DEX is not linked: …” means the section has no trading key — for example, the connection was set up in an older version of JetScalp. Click Link in that section’s Wallet field and sign the approval (see step 3).

Aster DEX did not accept the terminal’s key

The key may have expired (its lifetime is 1 year) or been revoked on Aster DEX. JetScalp then reports “Aster DEX rejected the terminal key (…). Link the wallet again: Connections → Wallet → Link.” Link the wallet again — click Link in the Wallet field, and JetScalp creates a new key.

If Aster DEX refuses already during linking, “Aster DEX did not approve the terminal key: …” appears under the Wallet field with the exchange’s reason. Check that you sign with the wallet that holds the Aster DEX account, and link the wallet again.

The wallet has not approved the JetScalp fee

If there is no fee approval or its cap is below 0.01%, the section does not connect and JetScalp shows this message:

Aster DEX Futures: the wallet has not approved the JetScalp fee (0.01% per order). Link the wallet again in the connection window — the wallet signs the approval while linking. Connection stopped.

For spot the message starts with “Aster DEX Spot”. Link the wallet in that section again and confirm all signatures (see step 3).

The message “Aster DEX Futures: could not check the builder fee approval (…).” (or “Aster DEX Spot: …”) means JetScalp did not get the exchange’s answer to the approval check — the reason is in the parentheses.

Aster DEX did not accept the spot fee approval

The message “The key is approved, but Aster DEX did not accept the spot fee approval” appears when linking the wallet in the Spot section: the trading key is approved, but the second signature is not. Click Link again and confirm both signatures.

Wallet on another network

Aster DEX accepts the signature only on BNB Smart Chain, Ethereum and Arbitrum One. Switch your wallet to one of them and try again.

No wallet found on the signing page

The page looks for wallets in the browser it is open in. Install the wallet extension, or paste the copied link into the browser where your wallet is installed.

Hedge mode is enabled

If JetScalp reports that the Aster DEX Futures account is in Hedge Mode, switch the position mode to One-way Mode (see step 4).

Security

JetScalp never asks for your seed phrase or wallet private key. Neither the connection settings nor the signing page has such fields. The wallet only signs an approval for the trading key created by JetScalp and the JetScalp fee cap.

The trading key can place and cancel orders but cannot withdraw funds: JetScalp requests it with withdrawals disabled (canWithdraw = false), and this is visible in the approval your wallet signs.

A seed phrase lets anyone restore your wallet and control all the funds in it. Never share it — not with support staff, developers or Telegram channel administrators. Genuine JetScalp support never asks for it. Do not store your seed phrase in messengers, email, text files, screenshots, public repositories or unprotected cloud storage; the safest option is to write it down on paper and keep it in a safe place.

Check what you are signing: the JetScalp page and the wallet window should show only an approval for a trading key without withdrawals and the JetScalp fee cap. Do not sign requests you do not understand.

If you no longer use the connection, click Unlink in the Wallet field of each section and confirm: JetScalp forgets the wallet and its key, and “Wallet unlinked.” appears under the field. On the exchange itself, the key remains until it is replaced or expires.

Last updated on