Deno quickstart
Read a public BTCUSDT price with bitget-api. No API key is needed. Prices are BTCUSDT last traded prices.
Install Deno first. You can also view the complete Bitget Deno example on GitHub.
These examples use public market data. Keep authenticated account and trading calls on your server. See Runtime setup for the scope of each recipe; a successful build does not verify live exchange access.
Create the project
mkdir bitget-deno-quickstart
cd bitget-deno-quickstart1. Create package.json
Declare the SDK dependency and the commands used by this project.
{
"name": "bitget-deno-quickstart",
"private": true,
"type": "module",
"dependencies": {
"bitget-api": "latest"
}
}2. Create deno.json
Tell Deno to install npm dependencies locally and define the price and stream tasks.
{
"nodeModulesDir": "auto",
"tasks": {
"start": "deno run --allow-net --allow-env --allow-read price.js",
"stream": "deno run --allow-net --allow-env --allow-read stream.js"
}
}3. Install dependencies
deno installRead a price
Create price.js to make a public REST request.
import { RestClientV3 } from 'bitget-api';
const client = new RestClientV3();
const response = await client.getTickers({
category: 'SPOT',
symbol: 'BTCUSDT',
});
const price = response.data[0]?.lastPrice;
if (!price) {
throw new Error('No BTCUSDT price was returned.');
}
console.log('BTCUSDT REST price:', price);Run it:
deno task startBTCUSDT REST price: 65000.5Stream a price (optional)
Create stream.js to stream WebSocket prices until Ctrl+C.
import { WebsocketClientV3 } from 'bitget-api';
import process from 'node:process';
const ws = new WebsocketClientV3();
ws.on('update', (message) => {
if (message.arg?.topic !== 'ticker') {
console.log('WebSocket update:', message);
return;
}
const price = message.data?.[0]?.lastPrice;
if (price) {
console.log('BTCUSDT WebSocket price:', String(price));
}
});
ws.on('response', (message) => {
console.log('WebSocket response:', message);
});
ws.on('exception', (error) => {
console.error('WebSocket exception:', error);
});
ws.on('reconnect', (event) => {
console.log('WebSocket reconnecting:', event);
});
ws.on('reconnected', (event) => {
console.log('WebSocket reconnected:', event);
});
function stop() {
ws.closeAll();
console.log('WebSocket closed.');
}
process.once('SIGINT', stop);
process.once('SIGTERM', stop);
ws.subscribe({
topic: 'ticker',
payload: {
instType: 'spot',
symbol: 'BTCUSDT',
},
}, 'v3Public').catch((error) => {
console.error('WebSocket subscription failed:', error);
});Run it:
deno task streamThe script keeps streaming until Ctrl+C. Exceptions and reconnections are logged; signal handlers close the client. SDK connection logs may also appear:
BTCUSDT WebSocket price: 65001.2
WebSocket closed.Troubleshooting
Use
deno task startto retain the documented permissions. A permission prompt or denial can mean you randeno run price.jsdirectly. Network access is needed for the public exchange; environment and read access support npm dependencies.Keep
nodeModulesDir: "auto"indeno.jsonand rundeno installif npm dependencies cannot be resolved.If a request fails or no stream updates arrive, check HTTPS and WSS access to the exchange from your network and region.
See Runtime setup for setup details and WebSocket subscriptions for continuous streams.