API Documentation

The CryptoVault1 API allows you to programmatically create wallets, check balances, send transactions, and manage tokens. All responses are in JSON format.

Base URL
https://goypall.net/api/v1

Authentication

All API requests require authentication. Include your API key in the request header:

X-API-Key: your_api_key_here

To get an API key, register an account and generate one from your profile settings, or contact the administrator.

Endpoints

POST /api/v1/register Create a new user account
Request Body 
{
    "name": "John Doe",
    "email": "john@example.com",
    "password": "securepassword123"
}
Response 
{
    "success": true,
    "user_id": 5,
    "message": "Account created successfully"
}
POST /api/v1/login Authenticate and get API token
Request Body 
{
    "email": "john@example.com",
    "password": "securepassword123"
}
Response 
{
    "success": true,
    "token": "a1b2c3d4e5f6...",
    "user": {
        "id": 5,
        "name": "John Doe",
        "email": "john@example.com"
    }
}
GET /api/v1/chains List all supported chains
Response 
{
    "success": true,
    "chains": [
        {"id": 1, "name": "Ethereum", "slug": "ethereum", "symbol": "ETH"},
        {"id": 2, "name": "Bitcoin", "slug": "bitcoin", "symbol": "BTC"},
        ...
    ]
}
POST /api/v1/wallets/create Create a wallet on a chain
Headers 
X-API-Key: your_token_from_login
Request Body 
{
    "chain": "ethereum"
}
Response 
{
    "success": true,
    "wallet": {
        "id": 12,
        "chain": "ethereum",
        "address": "0x742d35Cc6634C0532925a3b844Bc9...",
        "symbol": "ETH"
    }
}
GET /api/v1/wallets List all your wallets
Headers 
X-API-Key: your_token_from_login
Response 
{
    "success": true,
    "wallets": [
        {
            "id": 12,
            "chain": "ethereum",
            "address": "0x742d35Cc...",
            "symbol": "ETH",
            "balance": "1.25"
        }
    ]
}
GET /api/v1/wallets/{id}/balance Get wallet balance
Response 
{
    "success": true,
    "balance": "1.25",
    "symbol": "ETH",
    "usd_value": "4012.50"
}
GET /api/v1/wallets/{id}/transactions Get transaction history
Response 
{
    "success": true,
    "transactions": [
        {
            "tx_hash": "0xabc123...",
            "type": "receive",
            "amount": "0.5",
            "from": "0x123...",
            "to": "0x456...",
            "status": "confirmed",
            "date": "2026-03-20 14:30:00"
        }
    ]
}
POST /api/v1/wallets/{id}/send Send a transaction
Request Body 
{
    "to_address": "0x742d35Cc6634C0532925a3b844Bc9...",
    "amount": "0.1",
    "token_id": null
}
Response 
{
    "success": true,
    "tx_hash": "0xdef456...",
    "message": "Transaction submitted"
}
GET /api/v1/prices?symbols=BTC,ETH,SOL Get USD prices
Response 
{
    "success": true,
    "prices": {
        "BTC": 64250.00,
        "ETH": 3210.50,
        "SOL": 142.30
    }
}

Error Responses

All errors return a consistent format:

{
    "success": false,
    "error": "Description of what went wrong"
}

Rate Limits

API requests are limited to 60 requests per minute per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response.

Example: cURL

# Create a wallet
curl -X POST https://goypall.net/api/v1/wallets/create \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_token_here" \
  -d '{"chain": "ethereum"}'

# Check balance
curl -H "X-API-Key: your_token_here" \
  https://goypall.net/api/v1/wallets/12/balance