This is a client library for interacting with the Suredbits APIs for NFL, NBA and cryptocurrency market data. See our API docs for more information.
You're also welcome to join our Slack, if you have any questions about our APIs, our open source Bitcoin library Bitcoin-S or just want to discuss Bitcoin, Lightning, NBA & NFL or anything else.
$ yarn add sb-api$ npm install --save sb-apiOur APIs are paid for by using the Bitcoin Lightning Network. We suport the major Lightning implementations: lnd, c-lightning and Eclair.
We assume you have a running Lightning client. Behind the scenes it does two things with the provided client:
- Pay invoices. We pay for access to the Suredbits` APIs by paying Lightning invoices.
- Generate invoices without an amount specified. When setting up a subscription we provide a refund invoice where money can be refunded to us if we abort or subscription before it's up or something causes the server to abort the subscription.
You should not keep large amounts of money on the node you're using with this library.
import { Eclair, Sockets } from 'sb-api'
const eclair = await Eclair({ rpcPass: 'super_secret' })
const futuresSocket = await Sockets.exchangeSpot(eclair)import { Lnd, Sockets } from 'sb-api'
const lnd = await Lnd()
// You then pass lnd into the appropriate socket/REST API you're interested in.import { CLightning } from 'sb-api'
const client = await CLightning()
// You then pass client into the appropriate socket/REST API you're interested in.See doc/ln-clients.md for more information on how to use your favorite LN implementation, and what the available options are.
We provide REST APIs for data that are not realtime-based (such as
historical market data). These functions are regular promises
that can call .then or await on. Behind the scenes we make a HTTP
request, pay the accompanying invoice and then use the preimage of the
invoice to decrypt the received data.
const lnd = await Lnd()
const historicalRest = HistoricalRestAPI(lnd)
const historicalResponse = await historicalRest.call({
exchange: 'bitstamp',
pair: 'BTCUSD',
period: 'daily',
year: 2018,
})
const nflRest = NflRestAPI(lnd)
const nflResponse = await nflRest.players({
firstName: 'Colin',
lastName: 'Kaepernick',
})We provide streaming realtime data over WebSockets. These APIs require you to specify callbacks (functions) that gets executed whenever certain events happen. Note that if you're using TypeScript, the callbacks are fully typed, with inferred types from the exchange you're requesting data from.
import { Lnd, Sockets } from 'sb-api'
const ln = await Lnd()
const spot = await Sockets.exchangeSpot(ln)
spot.tickers({
duration: 10000,
exchange: 'binance',
// data has types! data.bidSize works, data.wrongField gives an error
onData: data => console.log('received some data:', data),
// snap has types! snap.map(s => handleS(s)) works, snap.wrongField gives an error
onSnapshot: snap => console.log('received a snapshot:', snap),
// this callback is called at the end of your subscription, and provides
// you with a list of all the elements you've received
onSubscriptionEnded: datapoints => datapoints[0],
refundInvoice,
})
// the comments above on the callbacks used for the spot socket
// also apply for the futures socket
const futures = await Sockets.exchangeFutures(ln)
futures.trades({
exchange: 'bitmex',
symbol: 'BTCUSD',
interval: 'biquarterly',
onData: data => data,
onSnapshot: snap => snap[0],
onSubscriptionEnded: datapoints => datapoints[0],
duration: 20000,
})
const nbaSocket = await Sockets.nbaTestnet()
const dalRoster = await nbaSocket.roster({ teamId: 'DAL' })See our API docs for complete code samples for making requests, as well as what responses look like, for all API endpoints and request types.
We recommend using TypeScript with this library. It has excellent type support built in, as it's written in TypeScript. When using TS you'll have all parameters passed to your requests type checked. The data type of the argument in onData or onSnapshot in a exchange socket will also change based on which exchange and which data type (tickers, books or trades) you request.
This library uses the debug module for logging what's going on. debug logs using what it calls namespaces. This library logs under the following namespaces:
sb-abi:lightning:lnd- LND related functionalitysb-api:lightning:eclair- Eclair related functionalitysb-api:lightning:clightning-c-lightningrelated functionalitysb-api:socket:base- functionality common for all socketssb-api:socket:ppc- functionality common for pay-per-call sockets (NBA)sb-api:socket:exchange- crypto market data loggingsb-api:validation- logs the validation of incoming data from the APIsb-api:rest- logs queries and responses to the Suredbits REST APIs
To activate logging output for a given namespace you need to set the DEBUG environment variable. Namespaces are hierarchically organized with : as the level separator. It's possible to specify multiple namespaces by comma-separating them. DEBUG=sb-api:* causes all namespaces to get logged. Setting DEBUG to sb-api:socket:* activates the sb-api:socket:base, sb-api:socket:ppc and sb-api:socket:exchange namespaces.
DEBUG=sb-api:lightning:*,sb-api:socket:base,sb-api:socket:ppc would enable logging of all Lightning activity, the functionality common for all sockets and the functionality common for pay-per-call sockets (NBA).
The script decrypt.ts is provided as a utility script for decrypting payloads adhering
to the PAID standard.
Usage: npx ts-node -T decrypt.ts $encrypted_payload $invoice_preimage.
$ yarn publish
Lints, checks formatting, makes new git tag, pushes new git tag, build, pushes build to npm
When testing this library, you need two secret environment variables, MAGIC_UUID and MAGIC_PREIMAGE. After that, simply do:
$ env MAGIC_UUID=... MAGIC_PREIMAGE=... yarn test --your --options --to --jest --here