API Documentation v1.0

Automate your crypto operations with our robust REST API.

1. Authentication

All API requests must be authenticated using the x-api-key header. You can manage your keys in Settings.

# Example Header
x-api-key: fly_7a2b...

HTTP Status Codes

200 OK Request successful. 400 Bad Req Missing fields or invalid parameters. 401 Unauth Invalid or missing API Key. 403 Forbid Plan too low for this action. 429 Too Many Rate limit reached (check your plan).

2. Developer Tools

Postman Collection

One-click import to your local Postman app.

Quick Start Code

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://flywl.xyz/api/v1';

async function getWallets() {
  try {
    const res = await axios.get(`${BASE_URL}/wallets`, {
      headers: { 'x-api-key': API_KEY }
    });
    console.log(res.data);
  } catch (err) {
    console.error(err.response ? err.response.data : err.message);
  }
}

getWallets();

3. Endpoints Reference

Wallets Management

GET /api/v1/wallets
List Portfolios

Returns an array of all wallets owned by the account.

Response Example
{
  "success": true,
  "wallets": [
    { "address": "bc1q...", "symbol": "BTC", "label": "Main" }
  ]
}
POST /api/v1/wallets
Create New

Generate a new blockchain address.

Body (JSON): { "symbol": "BTC" | "LTC", "label": "string" }

Payments & Transactions

GET /api/v1/wallets/:addr/transactions
History

Retrieve recent transaction history for an address.

POST /api/v1/transaction/send
⚠️ Critical

Broadcast a transaction to the network.

{
  "fromAddress": "string",
  "toAddress": "string",
  "amount": number,
  "subtractFee": boolean
}

Note: The amount should be in full units (e.g., 1.5 BTC).

Network & Utilities

GET /api/v1/transaction/:txid
Lookup TX

Get detailed status of a specific transaction ID (BTC).

GET /api/v1/market/ticker
Prices

Live crypto prices (USD/EUR) for BTC, ETH, LTC, SOL, USDT.

GET /api/v1/network/fees
Fee Estimates

Recommended fee rates for fast/medium confirmation.

API Explorer

Rate Limits
  • Premium: 5 req / min
  • Unlimited: 120 req / min