VLAD Documentation

Learn how to integrate with VLAD's API and start executing trades programmatically.

Prerequisites - A Robinhood Chain wallet - API credentials from the VLAD dashboard - Node.js 18+ or equivalent runtime

Quick Start 1. Connect your wallet to VLAD 2. Generate your API key in settings 3. Use your key to authenticate requests 4. Execute your first trade

For detailed setup instructions, visit our GitHub repository.

VLAD provides RESTful APIs for executing trades and querying asset information.

Available Endpoints

#Trade Execution `POST /api/v1/trades` Execute a trade with pricing transparency

#Asset Pricing `GET /api/v1/assets` Retrieve real-time pricing for all 95+ tokenized assets

#Order Status `GET /api/v1/trades/:tradeId` Check the status and settlement of your orders

#Wallet History `GET /api/v1/wallet/history` View all settlements and transaction history

All endpoints require authentication via Bearer token.

VLAD uses JWT-based authentication for all API requests.

API Key Generation 1. Log into the VLAD dashboard 2. Navigate to Settings → API Keys 3. Click "Generate New Key" 4. Store your key securely

Using Your API Key Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limiting - Standard tier: 100 requests/minute - Premium tier: 1000 requests/minute - Enterprise: Custom limits

Rate limit information is included in response headers.

VLAD settles all trades directly to your wallet on Robinhood Chain.

Settlement Flow 1. Trade is executed on VLAD 2. Tokens are transferred to your wallet 3. Transaction is recorded on-chain 4. You maintain full custody immediately

Non-Custodial Model Your private keys remain in your control at all times. VLAD never holds your assets. All settlements are direct wallet-to-wallet transfers.

Transaction Confirmation Settlement confirmations appear in your wallet within 30 seconds. You can verify each transaction on the Robinhood Chain explorer.

VLAD returns standard HTTP status codes and detailed error messages.

Common Error Codes - 400: Invalid request parameters - 401: Authentication failed - 403: Insufficient balance - 404: Asset or order not found - 429: Rate limit exceeded - 500: Internal server error

Error Response Format ```json { "error": "Insufficient balance", "code": "INSUFFICIENT_BALANCE", "details": "Required: 100 USDC, Available: 50 USDC" } ```

Always check error responses to understand failure reasons.

Example code for common VLAD operations.

Execute a Trade ```javascript const response = await fetch('https://api.vlad.ai/v1/trades', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ asset: 'AAPL', quantity: 10, side: 'buy' }) }); ```

Check Pricing ```javascript const prices = await fetch('https://api.vlad.ai/v1/assets?symbols=AAPL,MSFT,GOOGL', { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }); ```