API Overview

Introduction to the Paratro REST API

API Overview

The Paratro API is a RESTful API for managing MPC wallets, blockchain accounts, assets, and transfers.

Base URL

Environment	Base URL
Production	https://api.paratro.com/api/v1
Sandbox	https://api-sandbox.paratro.com/api/v1

Use the Sandbox environment for development and testing. Switch to Production when you’re ready to go live.

Authentication

All protected endpoints require a JWT token in the Authorization header. Obtain a token via POST /auth/token using your API Key and API Secret:

# 1. Get token
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')

# 2. Use token
curl https://api.paratro.com/api/v1/wallets \
  -H "Authorization: Bearer $TOKEN"

Response Format

Single resource (HTTP 200):

{
  "wallet_id": "w_01HXYZ...",
  "wallet_name": "My Wallet",
  "status": "PROGRESSING",
  "created_at": "2025-01-15T10:30:45+08:00"
}

Paginated list (HTTP 200):

{
  "data": [...],
  "total": 42,
  "has_more": true
}

Field	Type	Description
data	array	Resource list for current page
total	integer	Total count across all pages
has_more	boolean	Whether more pages exist

Error (HTTP 4xx / 5xx):

{
  "code": "not_found",
  "type": "not_found_error",
  "message": "Wallet not found"
}

Error Code Reference

Client Errors (4xx)

HTTP	Code	Type	Description
400	bad_request	invalid_request_error	Malformed request
400	invalid_parameter	invalid_request_error	Missing or invalid parameter
400	validation_failed	invalid_request_error	Field validation failed
401	unauthorized	authentication_error	Missing or invalid credentials
401	invalid_token	authentication_error	JWT token is invalid
401	token_expired	authentication_error	JWT token has expired
403	forbidden	permission_error	Access denied
404	not_found	not_found_error	Resource not found
409	conflict	conflict_error	Resource conflict
429	too_many_requests	rate_limit_error	Rate limit exceeded

Business Errors (400)

HTTP	Code	Type	Description
400	wallet_limit_reached	business_error	Maximum wallet count exceeded
400	insufficient_balance	business_error	Insufficient balance for operation
400	invalid_address	business_error	Invalid blockchain address
400	transaction_failed	business_error	Transaction execution failed
400	asset_already_exists	business_error	Asset already added to account
400	wallet_not_active	business_error	Wallet is not in active state
400	account_not_active	business_error	Account is not in active state
400	concurrency_error	business_error	Concurrent operation conflict

Server Errors (5xx)

HTTP	Code	Type	Description
500	internal_error	api_error	Internal server error
503	service_unavailable	api_error	Service temporarily unavailable

Endpoints

Method	Endpoint	Description
POST	/auth/token	Issue JWT token
POST	/wallets	Create wallet
GET	/wallets/:id	Get wallet
GET	/wallets	List wallets
POST	/accounts	Create account
GET	/accounts/:id	Get account
GET	/accounts	List accounts
POST	/assets	Add asset
GET	/assets/:id	Get asset
GET	/assets	List assets
POST	/transfer	Create transfer
GET	/transactions/:id	Get transaction
GET	/transactions	List transactions