Skip to main content
This guide walks you through making your first Partna API call. By the end, you will have fetched live conversion rates and understand the basic request pattern for every endpoint.

​
1. Get your API credentials

1

Request access

Fill out the onboarding form. The Partna team will reach out to schedule a brief onboarding call and set up your merchant account.
2

Create your API keys

Once your merchant account is set up, log in to the Partna dashboard and generate your API keys. You will get separate keys for staging and production:Each request requires two credentials:
  • x-api-user: Your merchant username
  • x-api-key: Your API key (generated from the dashboard)
3

Use staging first

Build and test against the staging environment before deploying to production. Staging supports mock deposits and test transactions at no cost.

​
2. Make your first request

Fetch the current conversion rates. This is the simplest authenticated request and confirms your credentials work. 
curl --request GET \
  --url https://staging-api.getpartna.com/v4/rate \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-api-user: YOUR_USERNAME'

​
3. Check the response

A successful response returns current conversion rates: 
{
  "data": {
    "rate": {
      "USDT_to_USD": {
        "fromAmount": 1,
        "fromCurrency": "USDT",
        "key": "1-USDT_to_USD-bbfcdc61-1755873777",
        "rate": 1,
        "toAmount": 1,
        "toCurrency": "USD"
      },
      "ETH_to_USD": {
        "fromAmount": 1,
        "fromCurrency": "ETH",
        "key": "2400-ETH_to_USD-5ddc8f46-1755873777",
        "rate": 2400,
        "toAmount": 2400,
        "toCurrency": "USD"
      }
    }
  },
  "message": "success"
}
Each rate object includes a key field. You will use this key when initiating ramp transactions to lock in the quoted rate.

​
4. Set up your webhook endpoint

Before processing real transactions, configure a webhook URL to receive status updates. You can do this via the dashboard or the Update Webhook URL endpoint. Your webhook endpoint should return a 200 status code immediately upon receiving the event. Process the event asynchronously.

​
Next steps

You are now authenticated and can fetch rates. Here is what to build next, depending on your use case:
Use caseGuide
Users convert local currency to cryptoOnramp Guide
Users convert crypto to local currencyOfframp Guide
Collect payments and settle in USD/stablecoinsCollect and Settle Guide
Verify user identity for transactionsAccounts and KYC Guide
Test with mock transactions in stagingTesting Guide