v1.0

BitBabble API

BitBabble API for sentiment analysis. Authenticate with your API key via Bearer auth.

Official SDK

Get started in seconds with the official BitBabble SDKs for JavaScript/TypeScript and Python.

Install

npm install bitbabble

Quick Start

import { BitBabbleClient } from "bitbabble";

const client = new BitBabbleClient("bb_your_api_key_here");
const result = await client.sentiment("Bitcoin ETF approved!");
console.log(result.sentiment, result.score);

Source and documentation: github.com/bitbabble/bitbabble-sdk

Authentication

All requests require a valid API key sent as a Bearer token in the Authorization header. Create and manage keys from your dashboard. If you're using an official SDK, authentication is handled automatically.

Keep your API keys secret. Do not expose them in client-side code or public repositories.

Setup

import { BitBabbleClient } from "bitbabble";

// Auth is handled automatically by the SDK
const client = new BitBabbleClient("bb_your_api_key_here");

Sentiment

Sentiment analysis endpoints

Analyze sentiment

post/api/v1/sentiment

Request Body

Field	Type	Description
`text`required	`string`	Text to analyze (max 140 characters)(min: 1, max: 140)

Response

Field	Type	Description
`sentiment`required	`"negative" \| "neutral" \| "positive"`	Predicted sentiment label
`score`required	`number`	Score from -1 (bearish) to +1 (bullish)
`confidence`required	`"low" \| "medium" \| "high"`	Confidence of the prediction
`cached`required	`boolean`	Whether the result was served from this user's cache

Status Codes

200Sentiment analysis result

401Invalid or missing API key

402Insufficient credits

429Too many requests

Request

import { BitBabbleClient } from "bitbabble";

const client = new BitBabbleClient("bb_your_api_key_here");
const result = await client.sentiment("I love this product!");
console.log(result);

Response200

{
  "sentiment": "positive",
  "score": 0.82,
  "confidence": "high",
  "cached": false
}