Skip to main content

GRVT

arkham-logoarkham-logo

Connecting GRVT to Tealstreet​

GRVT (pronounced "gravity") is a hybrid cryptocurrency exchange that combines the security and efficiency of centralized exchanges with the transparency and self-custody features of decentralized exchanges. GRVT uses EIP-712 signing with Ethereum private keys for order authentication.

info

GRVT requires you to use an Ethereum private key to sign orders. This private key is used to derive a Signer Address which must be tagged to your API key in the GRVT UI before you can trade.

info

Tealstreet now also asks you to complete a one-time Builder Fee Authorization for GRVT to support ongoing development. This authorization is done in your browser wallet and is network-specific (mainnet vs testnet).

tip

It's a good idea to keep both Tealstreet and GRVT tabs open for the duration of this process.

  • Click the 'Settings' button near the top right corner of the terminal.
Adding API
  • Click the 'Add new key' button at the bottom of the settings page.
TS Dropdown
  • Choose GRVT from the exchange selection menu.
Exchange Selection
  • Now lets go to our GRVT account and create the API key.

Step 1: Creating your SecureKey​

You will need to create a SecureKey to be able to create an API Key for integration with Tealstreet.

  1. Navigate to GRVT and login or create your account if you haven't already.
  2. Click on the Create SecureKey button in the top right corner of the page.
  3. Follow the prompt steps, including getting the one-time code from your email.
API Key Signer

Step 2: Creating your API Key​

After you created your SecureKey you will need to create an API Key.

API Create
  • Click Create to start the api creation process.
API Create2
  • You can either input an existing wallet or have GRVT generate a new one for you.
    • For the purposes of this example we will be using the generated wallet.
API Create3

In the Create API Key window:

  • Account Type: Trading Account (Not the Funding account)
  • Permissions: Select Trade
  • Label: Name this whatever you want
  • Address: This is your Signer Address that you will need later when linking the key to Tealstreet.
  • IP Whitelist: Insert the IP addresses that you can copy from the Tealstreet new API window.

Click Confirm to create the API Key.

API Create4

Store the API Key and the Secret Private Key. we now have 3/4 of the information we need to link our GRVT account to Tealstreet.

API Done

Now you should see your API in the management window. While here lets grab the Trading Account ID for the key we just created.

Step 3: Connecting the key to Tealstreet​

Now back to where we left the Tealstreet API page:

GRVT API Form
  • Proceed to fill out the form with the information you gathered:
    • Name: Give the key a name, this can be anything you want
    • Color: Choose the color you want your API to be in the terminal
    • API Key: The API Key you created in the GRVT UI
    • API Secret: Your Ethereum Private Key (64-char hex with or without 0x prefix)
    • Signer Address: Your Ethereum address derived from the private key
    • Trading Account ID: Your GRVT Trading Account ID / Sub-Account ID
    • Click the Done button
caution

Never share your Private Key or API Keys with anyone. Tealstreet team members will never ask you what your keys are.

If all the details are correct, you will have successfully linked your GRVT account to Tealstreet.

Step 4: Approve Builder Fee Authorization (GRVT)​

After adding your GRVT key in Tealstreet, you may see an Authorize Builder Fee prompt in the account form.

  • Click Authorize Builder Fee
  • Connect your browser wallet when prompted
  • Approve network switch/add request in your wallet
    • GRVT Mainnet: Chain ID 325 (RPC: https://rpc.grvt.io)
    • GRVT Testnet: Chain ID 326 (RPC: https://rpc.testnet.grvt.io)
  • Sign the EIP-712 authorization message

When successful, Tealstreet will show Builder authorized with the approved fee rate.

tip

If your wallet does not already have the required GRVT network configured, it will first prompt you to add it. This is expected.

caution

Builder fee authorization requires a browser wallet integration (for example, MetaMask). If you are using desktop mode without an injected browser wallet, complete this step in the web app.

  • Close options and navigate to the Main Trading page of the Tealstreet terminal and select the GRVT account you just linked to enable it.
    • If properly linked, you will see your balance appear in the Margin window of Tealstreet. Happy trading!!!

Frequently Asked Questions​

  • What is GRVT?
    • GRVT is a hybrid exchange combining CEX efficiency with DEX transparency. It offers crypto perpetual futures with up to 50x leverage, ultra-low fees, and self-custodial trading.

  • I get an error creating the API key saying access from this location is not allowed?

    • GRVT Has geolocational restrictions, Some users may be blocked from trading from certain countries.

  • My wallet asks me to switch/add a chain when I approve builder fee. Is that normal?

    • Yes. GRVT builder authorization uses GRVT EVM chain IDs and must match your selected network:
      • Mainnet uses chain ID 325
      • Testnet uses chain ID 326

  • What if I reject the chain switch or signature request?

    • The authorization will fail and your builder fee remains unapproved. Re-open the account settings and run Authorize Builder Fee again.

  • Where can I get more help?

Additional Resources​