Urban Sky SDKReal-time Balloon Telemetry

Choose Your Language ​

The Urban Sky SDK is available in two languages. Choose the one you prefer for your development environment:

• JavaScript/Node.js - Perfect for Node.js applications and server-side JavaScript
• Python - Ideal for Python applications and data processing workflows

Both SDKs provide identical functionality and real-time balloon telemetry access.

Quick Example ​

Get started with balloon updates in just a few lines of code:

// Load the SDK
const response = await fetch('https://sdk.atmosys.com/runtime/js/current/loader.js')
eval(await response.text())

// Initialize and connect to the SDK
const sdk = await UrbanSkySDK.init({
  apiToken: 'your-api-token',
})

// Listen for real-time balloon updates
sdk.on('balloon:update', update => {
  console.log('Balloon Update:', update.balloonId)

  update.devices.forEach(device => {
    console.log(`Device ${device.deviceId}:`)
    console.log(`  Location: ${device.lat}, ${device.lng}`)
    if (device.altitude) {
      console.log(`  Altitude: ${device.altitude}m`)
    }
  })
})

// SDK is already connected via init()

import requests

# Load the SDK
exec(requests.get('https://sdk.atmosys.com/runtime/py/current/loader.py').text)

sdk = await UrbanSkySDK.init({
    'apiToken': 'your-api-token'
})

def on_balloon_update(update):
    print(f"Balloon Update: {update.balloon_id}")

    for device in update.devices:
        print(f"Device {device.device_id}:")
        print(f"  Location: {device.lat}, {device.lng}")
        if device.altitude:
            print(f"  Altitude: {device.altitude}m")

# Listen for balloon updates
sdk.on('balloon:update', on_balloon_update)

# SDK is already connected via .init()

SDK Features ​

🔄 Real-time Updates ​

Stay connected to live balloon data with WebSocket-based real-time updates. No polling required.

📡 Multiple SDKs ​

Choose from JavaScript/TypeScript or Python SDKs, both with full feature parity and comprehensive documentation.

Need help getting started? We have an AI Assistant Guide that can generate a complete SDK implementation for your preferred language.

Ready to get started? Follow our Quick Start Guide →