Web3 API Reference

Introduction

This documentation covers our blockchain API endpoints for wallet management, transaction signing, and DApp integration.

Authentication

Use Bearer tokens in Authorization header. Tokens last 24h and can be revoked at any time.

curl -H "Authorization: Bearer YOUR_TOKEN" ...

Rate Limits

All API requests are subject to rate limits to prevent abuse. Free tier: 1000 reqs/min

• GET /wallets: 2000 requests/minute

• POST /transactions: 1000 requests/minute

Endpoints

POST /web3/wallets

Create a managed web3 wallet

Request Body

{
    "network": "ethereum",
    "label": "My Wallet",
    "tags": ["mobile", "personal"]
}

Response

{
    "walletAddress": "0x3cCa3F...aD22",
    "mnemonic": "recovery phrase encrypted with...",
    "createdAt": "2025-09-23T14:22:18Z"
}

PUT /web3/wallets/{id}/tags

Update wallet tags

Request Body

{
    "tags": ["project-ark", "mainnet"]
}

GET /web3/balance

Retrieve wallet balance in USD

Query Parameters

?address=0x3cCa3F...aD22

Response

{
    "address": "0x3cCa3F...aD22",
    "balanceUSD": 28456.34,
    "network": "ethereum",
    "lastUpdated": "2025-09-23T14:22:18Z"
}

Need Help?

Join our Discord or visit the FAQs for quick solutions.

Contact Support