> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create a wallet and send your first crypto transaction in minutes

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.

> [!NOTE]
>
> Before starting, make sure you have a Yativo account with 2FA enabled and an API key with `read`, `write`, and `transactions` permissions. Create your account in the dashboard and generate a key under **API Keys**. See [API Keys](https://docs.yativo.com/yativo-crypto/api-keys).

***

**1. Authenticate**

Exchange your API credentials for a Bearer token:

> [tab] cURL
>
> ```bash theme={null}
> curl -X POST https://crypto-api.yativo.com/api/v1/apikey/token \
>   -H "Content-Type: application/json" \
>   -d '{
>     "api_key": "yvk_live_...",
>     "api_secret": "yvs_live_..."
>   }'
> ```

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

**2. Create an account**

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

> [tab] cURL
>
> ```bash theme={null}
> curl -X POST https://crypto-api.yativo.com/api/v1/accounts/create-account \
>   -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "account_name": "Main Treasury",
>     "account_type": "business"
>   }'
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> const account = await client.accounts.create({
>   account_name: 'Main Treasury',
>   account_type: 'business',
> });
> console.log('Account ID:', account.id);
> ```

> [tab] Python
>
> ```python theme={null}
> account = client.accounts.create(
>     account_name='Main Treasury',
>     account_type='business',
> )
> print('Account ID:', account['id'])
> ```

```json Response theme={null}
{
  "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.

**3. Add a wallet**

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

> [tab] cURL
>
> ```bash theme={null}
> curl -X POST https://crypto-api.yativo.com/api/v1/assets/add-asset \
>   -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "account_id": "acc_01abc123",
>     "chain": "solana",
>     "ticker": "USDC_SOL"
>   }'
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> const wallet = await client.assets.add({
>   account_id: account.id,
>   chain: 'solana',
>   ticker: 'USDC_SOL',
> });
> console.log('Deposit address:', wallet.address);
> ```

> [tab] Python
>
> ```python theme={null}
> wallet = client.assets.add(
>     account_id=account['id'],
>     chain='solana',
>     ticker='USDC_SOL',
> )
> print('Deposit address:', wallet['address'])
> ```

```json Response theme={null}
{
  "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.

**4. Check balance**

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

> [tab] cURL
>
> ```bash theme={null}
> curl -X POST https://crypto-api.yativo.com/api/v1/balance/check \
>   -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{"asset_id": "asset_01xyz789"}'
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> const balance = await client.balance.check({ asset_id: wallet.id });
> console.log('Balance:', balance.balance, balance.ticker);
> ```

> [tab] Python
>
> ```python theme={null}
> balance = client.balance.check(asset_id=wallet['id'])
> print(f"Balance: {balance['balance']} {balance['ticker']}")
> ```

```json Response theme={null}
{
  "asset_id": "asset_01xyz789",
  "chain": "solana",
  "ticker": "USDC_SOL",
  "balance": "100.00",
  "balance_usd": "100.00",
  "last_updated": "2026-03-26T10:05:00Z"
}
```

**5. Send funds**

Send crypto from your wallet to an external address:

> [tab] cURL
>
> ```bash theme={null}
> curl -X POST https://crypto-api.yativo.com/api/v1/transactions/send-funds \
>   -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "account": "64b1f9e2a3c4d5e6f7a8b9c0",
>     "assets": "64b1f9e2a3c4d5e6f7a8b9d1",
>     "receiving_address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
>     "amount": 10,
>     "type": "USDC",
>     "chain": "solana",
>     "category": "payment",
>     "priority": "medium"
>   }'
> ```

> [tab] TypeScript
>
> ```typescript theme={null}
> const tx = await client.transactions.send({
>   account: wallet.accountId,
>   assets: wallet.id,
>   receiving_address: '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
>   amount: 10,
>   type: 'USDC',
>   chain: 'solana',
>   category: 'payment',
>   priority: 'medium',
> });
> console.log('Transaction ID:', tx.data._id);
> console.log('Status:', tx.data.status);
> ```

> [tab] Python
>
> ```python theme={null}
> tx = client.transactions.send(
>     account=wallet['account_id'],
>     assets=wallet['id'],
>     receiving_address='9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
>     amount=10,
>     type='USDC',
>     chain='solana',
>     category='payment',
>     priority='medium',
> )
> print('Transaction ID:', tx['data']['_id'])
> print('Status:', tx['data']['status'])
> ```

```json Response theme={null}
{
  "status": true,
  "message": "Transaction Created Successfully",
  "data": {
    "_id": "64c2a1f3b4d5e6f7a8b9c0d1",
    "account": "64b1f9e2a3c4d5e6f7a8b9c0",
    "assets": "64b1f9e2a3c4d5e6f7a8b9d1",
    "receiving_address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "amount": 10,
    "type": "USDC",
    "chain": "solana",
    "category": "payment",
    "status": "pending",
    "created_at": "2026-03-26T10:06:00Z"
  }
}
```

The transaction starts as `pending` and moves to `completed` once confirmed on-chain. Set up a [webhook](https://docs.yativo.com/yativo-crypto/webhooks) to get notified when it completes.

***

## What's Next

> [card] [Webhooks](https://docs.yativo.com/yativo-crypto/webhooks)
>
> Get notified in real time when deposits arrive or transactions complete.

> [card] [Supported Chains](https://docs.yativo.com/yativo-crypto/supported-chains)
>
> See all supported blockchains and tokens.

> [card] [Yativo Card](https://docs.yativo.com/yativo-crypto/cards/overview)
>
> Issue debit cards funded from crypto balances.

> [card] [Sandbox](https://docs.yativo.com/sandbox/overview)
>
> Test your integration safely without real funds.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.