Skip to content

Get started

This guide shows you how to get started with our API.

By the end of this guide, you will know how to:

Register on Gravv

You need register on Gravv to use the API. If you don't have an account, follow these steps:

  1. Visit the registration page.
  2. Enter your First name, Last name, Email address, and Business name in the appropriate fields.
  3. Check the box to agree to the Terms of use and Privacy policy.
  4. Click Sign up.
  5. Check your email for a verification message and visit the link to complete your registration.

You can only create an account with a business email address.

Select an environment

Once you've registered on Gravv, the next step is to select an environment. For more information, see Environments.

Create an account

After selecting an environment, create an account:

  1. In your Gravv dashboard, click Account in the side navigation.
  2. Click Create account.
  3. In Account Category, select the Sub account.
  4. In Account Type, select Regular Account.
  5. In Blockchain Network, select Ethereum if you are using the Sandbox environment mode, and Polygon if you are using the Live environment mode.
  6. In Bank, select Lead Bank.
  7. In the Label field, enter Operations.

Obtain your Api Key

Every request to the Gravv API requires an Api-Key. After creating a Gravv account, we generate two pairs of API keys for you: a publishable Public Key and a server-side Secret Key, for both Sandbox and Live modes.

To obtain your Api-Key, follow these steps:

  1. Sign in to your Gravv Dashboard with your registered business email address.
  2. Click Manage in the side navigation.
  3. Click Configure under the Manage section.
  4. Click API keys, then click the copy button under Secret Key to copy your Secret Key.

Now that you have obtained your Secret key, you can make your first request.

For more information, see Authentication

Whitelist your IP address

Follow these steps to whitelist your IP address before sending API requests:

  1. Follow steps 1 through 3 in Obtain Your API Key.
  2. Click IP Access List.
  3. Click Add IP Address.
  4. Enter your IP address in the IP Address field.