Bottle API

From Bottle Blue LLC

One key. Every endpoint.

Bottle API is one authenticated REST platform for financial and economic market data, weather and environment data, plants and smart garden automation, and general purpose developer utilities. JSON over HTTPS, versioned and stable.

Get Started FreeRead the Docs
  • 281REST endpoints
  • 34categories
  • 99.9%uptime target
  • v1stable

Powering

  • Bottle Blue LLC
  • Aqua Botany
  • PocketQuant
  • Trackless
  • Apparatus Ready

Everything you need to build

The same platform that powers Aqua Botany, PocketQuant, and the rest of the Bottle Blue LLC lineup, open to your next build.

  • Market and government data

    Twenty market categories, from crypto and rates to box office and drought, plus nine government datasets, news, trending tickers, and daily AI summaries in clean JSON. H-1B filings and WARN layoff notices are available in beta.

  • Weather and environment

    Forecasts plus air quality, soil, pollen, wildfire, earthquake, and moon data from trusted providers.

  • Plants and smart garden

    Plant knowledge, sensor readings, automation devices, and task scheduling for growing things.

  • Developer utilities

    Math, random numbers, time, unit conversion, queues, lists, streaks, and leaderboards on demand.

  • Community and gamification

    Feeds, articles, comments, likes, challenges, events, and rewards ready to drop into your product.

  • Auth, keys, and billing

    API keys, role based access control, and Stripe powered subscriptions are built into the platform.

Your first call in seconds

Grab a key, set one header, and every category is on the same host.

curl "https://api.bottlebluellc.com/v1/health" \
  -H "x-api-key: YOUR_API_KEY"

Full request and response examples for every endpoint live in the API reference.

Real data. Real endpoints.

No fixtures, no lorem ipsum. These are live calls against the same API your app would use.

Every disclosed stock trade from a sitting member of Congress, normalized into one JSON shape: ticker, amount, party, and chamber.

GET/government/congress
import requests

resp = requests.get(
    "https://api.bottlebluellc.com/v1/government/congress",
    headers={"x-api-key": API_KEY},
)
print(resp.status_code, resp.json())
200 OKresponse
{
  "dataset": "congress",
  "year": "2026",
  "count": 2,
  "items": [
    {
      "name": "Nancy Pelosi",
      "ticker": "NVDA",
      "transaction": "Purchase",
      "amount": 32500,
      "price_range": "$15,001 - $50,000",
      "party": "D",
      "house": "Representative",
      "report_date": "2026-07-02"
    },
    {
      "name": "Tommy Tuberville",
      "ticker": "XOM",
      "transaction": "Sale",
      "amount": 8000,
      "price_range": "$1,001 - $15,000",
      "party": "R",
      "house": "Senator",
      "report_date": "2026-06-30"
    }
  ]
}

Browse all endpoints, parameters, and languages in the API reference.

Simple pricing that scales with you

Start free, upgrade when your traffic does. Annual plans include two months free.

  • Free

    $0/mo

    • Account, keys and plan management
    • 100 requests every day, 10 a minute
    • Data access starts with Hobby
    • Community support
    Start Free

  • Hobby

    $5/mo

    • All data endpoints unlocked
    • 1,667 requests every day, 60 a minute
    • About 50,000 a month
    • Email support
    Choose Hobby
  • Most Popular

    Pro

    $25/mo

    • All data endpoints unlocked
    • 10,000 requests every day, 300 a minute
    • About 300,000 a month
    • Priority support
    Go Pro

  • Enterprise

    $299/mo

    • 100,000 requests every day, 1,000 a minute
    • Bulk access, caching and mirroring
    • API access for your own users
    • Dedicated support
    Choose Enterprise

  • Custom

    Talk to us

    • Volume and rate limits beyond Enterprise
    • Pricing to match your usage
    • Terms agreed in writing
    Contact Us

Your allowance resets every day, so a busy day never costs you the rest of the month. Rate limits are per day and per minute, and every response tells you where you stand. See the limits and the attribution requirement.

Commercial use inside your own product is included on every paid plan, including charging your own users by subscription. Handing our data onward to your users through an API, a feed or an export, keeping a standing copy of it, and sustained use above your plan are Enterprise. Read what you may do with the data.

Ready to build?

Create an account, mint a key, and make your first call before your coffee cools.

Sign UpBrowse the API