Quickstart

This guide takes you from zero to a completed on-chain transaction using the Yativo Crypto API. Each step includes examples in cURL, TypeScript, and Python.

Before starting, make sure you have a Yativo account with 2FA enabled and an API key with read, write, and transactions permissions. See the main Quickstart if you haven’t done this yet.

Authenticate

Exchange your API credentials for a Bearer token:

cURL
TypeScript
Python

curl -X POST https://crypto-api.yativo.com/api/apikey/token \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "yvk_live_...",
    "api_secret": "yvs_live_..."
  }'

import { YativoCrypto } from '@yativo/sdk';

const client = new YativoCrypto({
  apiKey: process.env.YATIVO_API_KEY!,
  apiSecret: process.env.YATIVO_API_SECRET!,
});
// The SDK handles token exchange automatically

from yativo import YativoCrypto

client = YativoCrypto(
    api_key=os.environ['YATIVO_API_KEY'],
    api_secret=os.environ['YATIVO_API_SECRET'],
)
# The SDK handles token exchange automatically

Save the access_token — you’ll use it as Authorization: Bearer {token} in all subsequent requests.

Create an account

Accounts are containers that hold wallets and assets. Create one for your business or for a specific use case:

cURL
TypeScript
Python

curl -X POST https://crypto-api.yativo.com/api/accounts/create-account \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_name": "Main Treasury",
    "account_type": "business"
  }'

const account = await client.accounts.create({
  account_name: 'Main Treasury',
  account_type: 'business',
});
console.log('Account ID:', account.id);

account = client.accounts.create(
    account_name='Main Treasury',
    account_type='business',
)
print('Account ID:', account['id'])

Response

{
  "id": "acc_01abc123",
  "account_name": "Main Treasury",
  "account_type": "business",
  "created_at": "2026-03-26T10:00:00Z"
}

Save the id — you’ll need it to add assets.

Add a wallet

Add a wallet for a specific chain and token to your account:

cURL
TypeScript
Python

curl -X POST https://crypto-api.yativo.com/api/assets/add-asset \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_01abc123",
    "chain": "solana",
    "ticker": "USDC_SOL"
  }'

const wallet = await client.assets.add({
  account_id: account.id,
  chain: 'solana',
  ticker: 'USDC_SOL',
});
console.log('Deposit address:', wallet.address);

wallet = client.assets.add(
    account_id=account['id'],
    chain='solana',
    ticker='USDC_SOL',
)
print('Deposit address:', wallet['address'])

Response

{
  "id": "asset_01xyz789",
  "account_id": "acc_01abc123",
  "chain": "solana",
  "ticker": "USDC_SOL",
  "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "balance": "0",
  "created_at": "2026-03-26T10:01:00Z"
}

The address is your deposit address. Share it with anyone who needs to send funds to this wallet.

Check balance

After funding the wallet (or for an existing asset), check the current balance:

cURL
TypeScript
Python

curl -X POST https://crypto-api.yativo.com/api/balance/check \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"asset_id": "asset_01xyz789"}'

const balance = await client.balance.check({ asset_id: wallet.id });
console.log('Balance:', balance.balance, balance.ticker);

balance = client.balance.check(asset_id=wallet['id'])
print(f"Balance: {balance['balance']} {balance['ticker']}")

Response

{
  "asset_id": "asset_01xyz789",
  "chain": "solana",
  "ticker": "USDC_SOL",
  "balance": "100.00",
  "balance_usd": "100.00",
  "last_updated": "2026-03-26T10:05:00Z"
}

Send funds

Send crypto from your wallet to an external address:

cURL
TypeScript
Python

curl -X POST https://crypto-api.yativo.com/api/transactions/send-funds \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from_asset_id": "asset_01xyz789",
    "to_address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "amount": "10.00",
    "chain": "solana",
    "ticker": "USDC_SOL",
    "priority": "medium"
  }'

const tx = await client.transactions.send({
  from_asset_id: wallet.id,
  to_address: '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
  amount: '10.00',
  chain: 'solana',
  ticker: 'USDC_SOL',
  priority: 'medium',
});
console.log('Transaction ID:', tx.transaction_id);
console.log('Status:', tx.status);

tx = client.transactions.send(
    from_asset_id=wallet['id'],
    to_address='9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
    amount='10.00',
    chain='solana',
    ticker='USDC_SOL',
    priority='medium',
)
print('Transaction ID:', tx['transaction_id'])
print('Status:', tx['status'])

Response

{
  "transaction_id": "txn_01pqr456",
  "status": "pending",
  "from_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "to_address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "amount": "10.00",
  "chain": "solana",
  "ticker": "USDC_SOL",
  "created_at": "2026-03-26T10:06:00Z"
}

The transaction starts as pending and moves to completed once confirmed on-chain. Set up a webhook to get notified when it completes.

What’s Next

Webhooks

Get notified in real time when deposits arrive or transactions complete.

Supported Chains

See all supported blockchains and tokens.

Yativo Card

Issue debit cards funded from crypto balances.

Sandbox

Test your integration safely without real funds.

Overview

Wallets & Assets

Transactions

Yativo Card

IBAN

B2B

Developer Tools

What’s Next

Webhooks

Supported Chains

Yativo Card

Sandbox

Overview

Wallets & Assets

Transactions

Yativo Card

IBAN

B2B

Developer Tools

​What’s Next

Webhooks

Supported Chains

Yativo Card

Sandbox

What’s Next