​
Converting from Kinetic to Gas Station API

This guide will help you migrate your existing Kinetic API integration to the new Gas Station API, which offers improved performance, simplified authentication, and better developer experience.

​
Key Differences

​
API Endpoints

  • Kinetic API: Used environment and index-based routing
  • Gas Station API: Uses direct endpoint paths with cleaner structure

​
Authentication

  • Kinetic API: Required environment and app configuration
  • Gas Station API: Simplified authentication with API keys

​
Base URL

  • Kinetic API: https://sandbox.kinetic.host or custom endpoints
  • Gas Station API: https://api.altude.so

​
Migration Steps

​
1. Update Base URL

Replace your Kinetic API base URL with the Gas Station API URL: 
- const baseURL = 'https://sandbox.kinetic.host'
+ const baseURL = 'https://api.altude.so'

​
2. Account Operations

​
Get Account Balance

Kinetic API: 
GET /api/account/balance/{environment}/{index}/{accountId}
Gas Station API: 
POST /api/Account/balance
{
  "accountAddress": "your_account_address",
  "mintAddress": "optional_mint_address"
}

​
Create Account

Kinetic API: 
POST /api/account/create
{
  "environment": "devnet",
  "index": 1,
  "commitment": "confirmed",
  "mint": "mint_address",
  "tx": "signed_transaction"
}
Gas Station API: 
POST /api/Account/create
{
  "signedTransaction": "base64_signed_transaction"
}

​
Get Account History

Kinetic API: 
GET /api/account/history/{environment}/{index}/{accountId}/{mint}
Gas Station API: 
POST /api/Account/gethistory?WalletAddress=wallet_address&PageNumber=1&PageSize=10

​
3. Transaction Operations

​
Send Transaction

Kinetic API: 
POST /api/transaction/make-transfer
{
  "environment": "devnet",
  "index": 1,
  "commitment": "confirmed",
  "mint": "mint_address",
  "tx": "signed_transaction"
}
Gas Station API: 
POST /api/Transaction/send
{
  "signedTransaction": "base64_signed_transaction"
}

​
Batch Transactions

The Gas Station API introduces a new batch transaction feature: 
POST /api/Transaction/sendbatch
{
  "signedTransaction": "base64_signed_batch_transaction"
}

​
Code Examples

​
Before (Kinetic API)

import { KineticSdk } from '@kinetic/kinetic-sdk'

const kinetic = new KineticSdk({
  endpoint: 'https://sandbox.kinetic.host',
  environment: 'devnet',
  index: 1
})

// Get balance
const balance = await kinetic.getBalance({
  account: 'account_address',
  mint: 'mint_address'
})

// Make transfer
const transaction = await kinetic.makeTransfer({
  amount: '1000000',
  destination: 'destination_address',
  mint: 'mint_address'
})

​
After (Gas Station API)

const API_BASE = 'https://api.altude.so'

// Get balance
const balanceResponse = await fetch(`${API_BASE}/api/Account/balance`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    accountAddress: 'account_address',
    mintAddress: 'mint_address'
  })
})

// Send transaction
const sendResponse = await fetch(`${API_BASE}/api/Transaction/send`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    signedTransaction: 'base64_signed_transaction'
  })
})

​
Benefits of Gas Station API

  • Simplified Architecture: No more environment/index management
  • Better Performance: Optimized endpoints for faster responses
  • Batch Operations: Send multiple transactions in a single request
  • Consistent API Design: RESTful endpoints with clear request/response patterns
  • Enhanced Security: Improved authentication and validation

​
Need Help?

If you need assistance with the migration or have questions about specific use cases, please reach out to our support team at andrew@altude.so.