API Reference

Overview

The Etheroute API provides programmatic access to manage wallets, transactions, and cryptocurrency operations. All API requests must be authenticated with a valid API key and use HTTPS.

Base URL: https://api.etheroute.io/api

Response Format: JSON

Authentication

All API requests require authentication using an API key in the Authorization header. Include your API key with the Bearer scheme.

Code Examples

curl -X GET https://api.etheroute.io/api/wallets/list \
  -H "Authorization: Bearer YOUR_API_KEY"

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/wallets/list', {
    method: 'GET',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
    }
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
        'https://api.etheroute.io/api/wallets/list',
        headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())

Generate API Key

Navigate to your dashboard, go to the API section, and click "Generate New Key". Store your key securely and never share it publicly.

Wallets

Retrieve all wallets for a specific client. Returns wallet information including address, balance, and blockchain.

Request Parameters

No parameters required. Client is determined from your API key.

Code Examples

curl -X GET https://api.etheroute.io/api/wallets/list \
  -H "Authorization: Bearer YOUR_API_KEY"

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/wallets/list', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.etheroute.io/api/wallets/list',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())

Example Response

[
    {
        "id": "b9cce974-cac6-4bf1-ab25-3162ac2e759d",
        "address": "0x8462Dc02DCCBD5de5483BE59717E948a3250df6E",
        "chain": "ETH",
        "balance": 0.003327959835621435,
        "balanceUSD": 7.059135284926763,
        "createdAt": "2026-05-20T21:05:15.566Z"
    },
    {
        "id": "2af44678-fb5a-4756-b2be-57de577dd21b",
        "address": "LfrqNk5h8c2JFt3wqM9Vm57d8ftrRZAUad",
        "chain": "LTC",
        "balance": 0.01351317,
        "balanceUSD": 0.7207924878,
        "createdAt": "2026-05-22T03:05:46.846Z"
    },
    {
        "id": "694d8c66-5ff9-4bd5-87ea-8b82ad1e3b69",
        "address": "0x64e4CAB10E2501681972DA31b902C73C5dFe7C31",
        "chain": "ETH",
        "balance": 0,
        "balanceUSD": 0,
        "createdAt": "2026-05-23T21:30:38.435Z"
    }
]

Requires Authentication

Generate a new wallet on a specified blockchain network. Returns a newly created wallet address and details.

Request Body

{
  "chain": "ETH"
}

chain: Blockchain network: ETH, BTC, SOL, or LTC. Required.

Code Examples

curl -X POST https://api.etheroute.io/api/wallets/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chain":"ETH"}'

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/wallets/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    chain: 'ETH'
  })
});
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.etheroute.io/api/wallets/generate',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={'chain': 'ETH'}
)
print(response.json())

Example Response

{
    "id": "31e4b9c6-2d4e-45fe-8be3-ab0708434c3f",
    "address": "0x60aeF11Ba4C4EFD44d4CB09248c10bBDCAfE5DCf",
    "chain": "ETH",
    "clientId": "0921623d-8f05-4bc6-a154-f37830341dc6",
    "balance": 0,
    "createdAt": "2026-05-25T15:42:25.190Z"
}

Requires Authentication

Delete a wallet. The wallet must be empty before deletion.

Request Body

{
    "walletId": "wallet_id"
}

walletId: The unique wallet identifier. Required.

Code Examples

curl -X DELETE https://api.etheroute.io/api/wallets/delete \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"walletId":"wallet_id"}'

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/wallets/delete', {
  method: 'DELETE',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({ walletId: 'wallet_id' })
});
const data = await response.json();
console.log(data);

import requests

response = requests.delete(
    'https://api.etheroute.io/api/wallets/delete',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={'walletId': 'wallet_id'}
)
print(response.json())

Example Response

{
  "message": "Wallet deleted successfully"
}

Requires Authentication

Transactions

Get all transactions for a client across all wallets and chains.

Request Parameters

No parameters required. Client is determined from your API key.

Code Examples

curl -X GET https://api.etheroute.io/api/transactions/list \
  -H "Authorization: Bearer YOUR_API_KEY"

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/transactions/list', {
  method: 'GET',
  headers: {'Authorization': 'Bearer YOUR_API_KEY'}
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.etheroute.io/api/transactions/list',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())

Example Response

[
  {
    "id": "a2203483-5be0-4d1a-938d-227ad6ah4081",
    "transactionHash": "0xe52c676de079c4ef5fec84dc7a890d4fa8eca844210783d8355582a95cc8785f",
    "type": "DIRECT_TRANSFER",
    "chain": "ETH",
    "nativeAmount": 0.0029685974191263225,
    "usdAmount": 6.110534469143884,
    "status": "CONFIRMED",
    "createdAt": "2026-05-22T18:39:30.841Z",
    "completedAt": "2026-05-22T18:39:51.411Z"
  }
]

Requires Authentication

Get transaction history for a specific wallet.

Request Body

{
    "walletId": "wallet_id"
}

walletId: The unique wallet identifier. Required.

Code Examples

curl -X GET https://api.etheroute.io/api/transactions/wallet \
  -H "Authorization: Bearer YOUR_API_KEY"

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/transactions/wallet', {
  method: 'GET',
  headers: {'Authorization': 'Bearer YOUR_API_KEY'}
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.etheroute.io/api/transactions/wallet',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())

Requires Authentication

Get details for a specific transaction by ID.

Request Body

{
    "transactionId": "transaction_id"
}

transactionId: The unique transaction identifier. Required.

Code Examples

curl -X GET https://api.etheroute.io/api/transactions/getTransaction \
  -H "Authorization: Bearer YOUR_API_KEY"

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/transactions/getTransaction', {
  method: 'GET',
  headers: {'Authorization': 'Bearer YOUR_API_KEY'}
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.etheroute.io/api/transactions/getTransaction',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())

Requires Authentication

Payouts

Retrieve payout history for a client.

Request Parameters

No parameters required. Client is determined from your API key.

Code Examples

curl -X GET https://api.etheroute.io/api/payouts/list \
  -H "Authorization: Bearer YOUR_API_KEY"

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/payouts/list', {
  method: 'GET',
  headers: {'Authorization': 'Bearer YOUR_API_KEY'}
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.etheroute.io/api/payouts/list',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())

Requires Authentication

Get details for a specific payout by ID.

Request Body

{
    "payoutId": "payout_id"
}

payoutId: The unique payout identifier. Required.

Code Examples

curl -X GET https://api.etheroute.io/api/payouts/getPayout \
  -H "Authorization: Bearer YOUR_API_KEY"

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/payouts/getPayout', {
  method: 'GET',
  headers: {'Authorization': 'Bearer YOUR_API_KEY'}
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.etheroute.io/api/payouts/getPayout',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())

Requires Authentication

Withdrawal

Initiate a cryptocurrency withdrawal to an external address. Minimum withdrawal is $5 USD equivalent.

Request Body

{
    "recipientAddress": "0x742d35Cc6634C0532925a3b844Bc122e5d6F0fA6",
    "selectedWallets": ["0xAbc123...", "bc1qxyz..."] // Optional - if omitted, withdrawal will be processed from all active wallets with available balance
}

recipientAddress: Destination wallet address. Required.
selectedWallets: Array of wallet addresses to withdraw from. Optional (auto-selects all active wallets if omitted).

Code Examples

curl -X POST https://api.etheroute.io/api/withdrawal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientAddress":"0x742d35...",
        "selectedWallets":["0xAbc123...","bc1qxyz..."]
  }'

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/withdrawal', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    recipientAddress: '0x742d35...',
        selectedWallets: ['0xAbc123...', 'bc1qxyz...']
  })
});
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.etheroute.io/api/withdrawal',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'recipientAddress': '0x742d35...',
        'selectedWallets': ['0xAbc123...', 'bc1qxyz...']
    }
)
print(response.json())

Important Notes

Minimum withdrawal: $5 USD equivalent per blockchain
Withdrawal processing typically takes 2-10 minutes
Network congestion may affect confirmation speed

Requires Authentication

Preview a withdrawal without creating it. Returns accurate fee and amount calculations.

Request Parameters

{
    "recipientAddress": "0x742d35Cc6634C0532925a3b844Bc122e5d6F0fA6",
    "selectedWallets": ["0xAbc123...", "bc1qxyz..."] // Optional - if omitted, preview will show all active wallets with available balance
}

recipientAddress (body): Destination wallet address. Required.
selectedWallets (body): Comma-separated list of wallet addresses. Optional.

Code Examples

curl -X POST https://api.etheroute.io/api/withdrawal/preview \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipientAddress":"0x742d35...","selectedWallets":"0xAbc123...,bc1qxyz..."}'

const fetch = require('node-fetch');

const response = await fetch('https://api.etheroute.io/api/withdrawal/preview', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      recipientAddress: '0x742d35...',
      selectedWallets: ['0xAbc123...', 'bc1qxyz...']
  })
});
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.etheroute.io/api/withdrawal/preview',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={"recipientAddress":"0x742d35...","selectedWallets":["0xAbc123...", "bc1qxyz..."]}
)
print(response.json())

Requires Authentication

Response Formats

Success Response: All successful API responses return HTTP 201 with JSON data.

Error Response: Failed requests return appropriate HTTP status codes (400, 401, 404, 500) with error details.

{
  "error": "ValidationError",
  "message": "Valid chain (ETH, BTC, LTC, SOL) is required"
}

400 Bad Request: Invalid parameters or missing required fields
401 Unauthorized: Invalid or missing API key
404 Not Found: Resource not found
500 Internal Server Error: Server error

Overview

Authentication

Wallets

Transactions

Payouts

Withdrawal

Response Formats

Support

Company

Legal