Documentation

API Reference

Everything you need to integrate ChainVue into your application.

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header as a Bearer token.

Header Format

Authorization: Bearer chain_live_your_api_key_here

Important: Keep your API keys secure. Never expose them in client-side code or public repositories.

Base URL

All API requests should be made to the following base URL:

https://api.chainvue.io/v1

List Transactions

Retrieve a paginated list of transactions for a given address. Supports filtering by date range, transaction type, and currency.

GET /v1/transactions

Query Parameters

Parameter	Type	Description
address	string	Required. The wallet address or VerusID.
limit	integer	Number of results (1-100, default: 20)
offset	integer	Pagination offset (default: 0)
type	string	Filter by type: send, receive, stake, convert

cURL Example

curl -X GET "https://api.chainvue.io/v1/transactions?address=RKjRdyaCxj4DNqQ9S2pDwrVkLzM1ygJSqo&limit=10" \
  -H "Authorization: Bearer chain_live_abc123..." \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "data": {
    "transactions": [
      {
        "txid": "a1b2c3d4e5f6...",
        "blockHeight": 3245891,
        "timestamp": "2024-11-25T14:32:00Z",
        "type": "send",
        "amount": "125.50000000",
        "currency": "VRSC",
        "from": ["RKjRdyaCxj4DNqQ9S2pDwrVkLzM1ygJSqo"],
        "to": ["RNtZ5tGzwjhZrVbx1WnHgF8p8cyXepTaQ3"],
        "fee": "0.0001",
        "confirmations": 142
      }
    ],
    "pagination": {
      "limit": 10,
      "offset": 0,
      "total": 1523
    }
  }
}

Node.js SDK

Install the official SDK for a better developer experience with TypeScript support.

Installation

npm install @chainvue/sdk

Usage Example

import { ChainVue } from '@chainvue/sdk';

const client = new ChainVue({
  apiKey: 'chain_live_abc123...'
});

// List recent transactions for an address
const transactions = await client.transactions.list({
  address: 'RKjRdyaCxj4DNqQ9S2pDwrVkLzM1ygJSqo',
  limit: 10
});

console.log(transactions.data);

// Resolve a VerusID to its address
const identity = await client.identities.resolve('verus@');
console.log(identity.address);

// Get current conversion rates
const rates = await client.currencies.rates({
  from: 'VRSC',
  to: 'DAI.vETH'
});
console.log(rates.rate);

Available Endpoints

GET

/v1/transactions

List transactions

GET

/v1/transactions/:txid

Get transaction details

GET

/v1/address/:address

Get address info

GET

/v1/address/:address/balance

Get balances

GET

/v1/identities/:name

Resolve VerusID

GET

/v1/identities/:name/history

ID history

GET

/v1/currencies

List currencies

GET

/v1/currencies/:id/rates

Conversion rates

GET

/v1/blocks/latest

Latest block

GET

/v1/blocks/:height

Block by height

GET

/v1/staking/rewards

Staking rewards

POST

/v1/webhooks

Create webhook