Skip to main content

​
Quickstart

This guide walks you through creating your first wallet, account, asset, and transfer using the Paratro API.

​
Prerequisites

  • A Paratro account with API Key and API Secret
  • See Authentication for details

​
Environments

EnvironmentBase URL
Productionhttps://api.paratro.com/api/v1
Sandboxhttps://api-sandbox.paratro.com/api/v1
The examples below use the Production URL. Replace with the Sandbox URL for testing.

​
Step 1: Authenticate

TOKEN=$(curl -s -X POST https://api.paratro.com/api/v1/auth/token \
  -H "X-API-Key: your_api_key" \
  -H "X-API-Secret: your_api_secret" | jq -r '.token')

​
Step 2: Create a Wallet

curl -s -X POST https://api.paratro.com/api/v1/wallets \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"wallet_name": "My Wallet", "description": "Primary wallet"}'
New wallets are not immediately ready for downstream operations. Wait until both status and key_status are ACTIVE before creating accounts.

​
Step 3: Create an Account

Create a blockchain account under the wallet. This generates an address on the specified chain. The gateway derives the account network value automatically from its chain registry. 
curl -s -X POST https://api.paratro.com/api/v1/accounts \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "<wallet_id>",
    "chain": "ethereum",
    "label": "Deposit Account"
  }'

​
Step 4: Add an Asset

Add a token to the account. Asset configuration (contract address, decimals) is resolved automatically. 
curl -s -X POST https://api.paratro.com/api/v1/assets \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "<account_id>",
    "symbol": "USDT",
    "chain": "ethereum"
  }'

​
Step 5: Create a Transfer

curl -s -X POST https://api.paratro.com/api/v1/transfer \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from_address": "<from_address>",
    "to_address": "0xbbbb...",
    "chain": "ethereum",
    "token_symbol": "USDT",
    "amount": "10.5"
  }'

​
Step 6: Check Transaction Status

curl -s https://api.paratro.com/api/v1/transactions/<tx_id> \
  -H "Authorization: Bearer $TOKEN"

​
Next Steps

Core Concepts

Understand wallets, accounts, and assets

Go SDK

Full SDK documentation

Webhooks

Set up transaction notifications

API Reference

Full endpoint documentation