Wallets

# Реестр монет
curl -X GET https://fin-os.io/api/v1/wallets/coins \
  -H "Authorization: Bearer sk_test_..."

# Все балансы казначейства
curl -X GET https://fin-os.io/api/v1/wallets \
  -H "Authorization: Bearer sk_test_..."

# Баланс одной монеты (мультичейн → уточните network)
curl -X GET "https://fin-os.io/api/v1/wallets/USDT/balance?network=TRON" \
  -H "Authorization: Bearer sk_test_..."

# Депозит-адрес
curl -X POST https://fin-os.io/api/v1/wallets/USDT/address \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"network": "TRON"}'

# Вывод на внешний адрес (может вернуть 503, пока вывод не включён)
curl -X POST https://fin-os.io/api/v1/wallets/USDT/withdraw \
  -H "Authorization: Bearer sk_test_..." \
  -d '{"to": "TExternalRecipientAddr...", "amount": "25.5", "network": "TRON"}'

const FINOS = 'https://fin-os.io/api/v1';
const SECRET = process.env.FINOS_SECRET_KEY; // sk_test_ или sk_live_
const H = { 'Authorization': `Bearer ${SECRET}`, 'Content-Type': 'application/json' };

// Депозит-адрес казначейства для монеты в конкретной сети
async function depositAddress(coin, network) {
  const res = await fetch(`${FINOS}/wallets/${coin}/address`, {
    method: 'POST',
    headers: H,
    body: JSON.stringify({ network }),
  });
  const { data } = await res.json();
  return data; // { asset, network, address, sandbox? }
}

// Вывод; корректно обрабатываем дормантный 503
async function withdraw(coin, to, amount, network) {
  const res = await fetch(`${FINOS}/wallets/${coin}/withdraw`, {
    method: 'POST',
    headers: H,
    body: JSON.stringify({ to, amount, network }),
  });
  if (res.status === 503) {
    // Вывод временно недоступен - повторите позже
    throw new Error('withdraw temporarily unavailable');
  }
  const { data } = await res.json();
  return data; // 202: { status: 'accepted', ..., tx_hash }
}

use Illuminate\Support\Facades\Http;

class FinosWallets
{
    private string $base = 'https://fin-os.io/api/v1';

    public function __construct(private string $secretKey) {}

    public function coins(): array
    {
        return Http::withToken($this->secretKey)
            ->get("{$this->base}/wallets/coins")
            ->json('data');
    }

    public function depositAddress(string $coin, ?string $network = null): array
    {
        return Http::withToken($this->secretKey)
            ->post("{$this->base}/wallets/{$coin}/address", array_filter([
                'network' => $network,
            ]))
            ->json('data');
    }

    public function withdraw(string $coin, string $to, string $amount, ?string $network = null): array
    {
        $res = Http::withToken($this->secretKey)
            ->post("{$this->base}/wallets/{$coin}/withdraw", array_filter([
                'to'      => $to,
                'amount'  => $amount,
                'network' => $network,
            ]));

        if ($res->status() === 503) {
            throw new \RuntimeException('Withdraw temporarily unavailable, retry later.');
        }

        return $res->json('data');
    }
}

import requests, os

FINOS = 'https://fin-os.io/api/v1'
KEY   = os.environ['FINOS_SECRET_KEY']  # sk_test_ или sk_live_
H     = {'Authorization': f'Bearer {KEY}'}

def coins():
    r = requests.get(f'{FINOS}/wallets/coins', headers=H)
    r.raise_for_status()
    return r.json()['data']

def deposit_address(coin, network=None):
    body = {'network': network} if network else {}
    r = requests.post(f'{FINOS}/wallets/{coin}/address', headers=H, json=body)
    r.raise_for_status()
    return r.json()['data']

def withdraw(coin, to, amount, network=None):
    body = {'to': to, 'amount': amount}
    if network:
        body['network'] = network
    r = requests.post(f'{FINOS}/wallets/{coin}/withdraw', headers=H, json=body)
    if r.status_code == 503:
        raise RuntimeError('Withdraw temporarily unavailable, retry later.')
    r.raise_for_status()
    return r.json()['data']

# usage
addr = deposit_address('USDT', 'TRON')
print('Deposit to:', addr['address'])