Skip to main content
This guide walks you through the minimum steps needed to start using Yativo’s API.
1

Create and verify your account

Go to crypto.yativo.com/sign-up and register with your email address and password.After registration, you’ll receive a verification email. Confirm your address before proceeding — unverified accounts cannot generate API keys.You can also register via the API:
curl -X POST https://crypto-api.yativo.com/api/authentication/registration \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password",
    "first_name": "Jane",
    "last_name": "Doe"
  }'
2

Enable two-factor authentication

API key creation requires 2FA to be active on your account. Set it up in the dashboard under Security > Two-Factor Authentication, or via the API:
curl -X POST https://crypto-api.yativo.com/api/auth/2fa/setup \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Scan the returned QR code with Google Authenticator or any TOTP app, then verify:
curl -X POST https://crypto-api.yativo.com/api/auth/2fa/verify \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"code": "123456"}'
2FA is required before you can create API keys. Keep your backup codes in a safe place.
3

Generate an API key

With 2FA enabled, create your first API key. You’ll need your current TOTP code in the X-2FA-Token header:
curl -X POST https://crypto-api.yativo.com/api/apikey/create \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-2FA-Token: 123456" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Key",
    "permissions": ["read", "write", "transactions"]
  }'
The response includes your api_key and api_secret. Store the secret immediately — it is only shown once.
{
  "id": "key_01abc...",
  "name": "My First Key",
  "api_key": "yvk_live_...",
  "api_secret": "yvs_live_...",
  "permissions": ["read", "write", "transactions"],
  "created_at": "2026-03-26T10:00:00Z"
}
4

Make your first API call

Use your API key and secret directly as headers, or exchange them for a Bearer token first.Option A: Use headers directly
curl -X GET https://crypto-api.yativo.com/api/apikey/list \
  -H "X-API-Key: yvk_live_..." \
  -H "X-API-Secret: yvs_live_..."
Option B: Exchange for a Bearer token (recommended for server-to-server)
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_..."
  }'
{
  "access_token": "eyJhbGci...",
  "expires_in": 3600
}
Then use the token:
curl -X GET https://crypto-api.yativo.com/api/apikey/list \
  -H "Authorization: Bearer eyJhbGci..."

Next Steps

Yativo Crypto Quickstart

Set up a crypto wallet and send your first on-chain transaction.

API Keys

Manage permissions, rotate secrets, and understand key scopes.

Webhooks

Get notified in real time when events happen on your account.

Authentication

Full reference for all authentication endpoints.