Bitcoin-Only APIbitcoin-only.com ↗
Access Bitcoin conferences, meetups, wallets, podcasts, developer tools, and privacy resources from bitcoin-only.com via a structured JSON API.
What is the Bitcoin-Only API?
The bitcoin-only.com API exposes 19 endpoints covering the full breadth of the Bitcoin-only resource directory — from upcoming and past conferences to developer tools, privacy utilities, and hardware wallets. Endpoints like get_meatspace_meetups return structured fields including country, region, city, organizer, and organizer URL, while get_wallets categorizes on-chain, lightning, custodial, and advanced storage options with descriptions and links.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/dcff37aa-d941-4b53-b38e-aaefde0161cb/get_upcoming_conferences' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace bitcoin-only-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Bitcoin Only SDK — explore the Bitcoin ecosystem."""
from parse_apis.bitcoin_only_api import BitcoinOnly, Country, NotFoundError
client = BitcoinOnly()
# List upcoming Bitcoin conferences with location and dates
for conf in client.conferences.list_upcoming(limit=3):
print(conf.name, conf.location, conf.dates)
# Get all conferences (upcoming + past) in one call
all_confs = client.conferencelists.get()
print(len(all_confs.upcoming), "upcoming,", len(all_confs.past), "past conferences")
# Filter meetups by country using the Country enum
for meetup in client.meetups.list_by_country(country=Country.USA, limit=5):
print(meetup.city, meetup.region, meetup.organizer)
# Browse Bitcoin books
book = client.books.list(limit=1).first()
if book:
print(book.title, book.author, book.author_url)
# Check developer tools across categories
for tool in client.tools.list_dev(limit=3):
print(tool.name, tool.category, tool.description)
# Get job listing info (redirects to external site)
try:
job_info = client.jobinfos.get()
print(job_info.message, job_info.redirect_url)
except NotFoundError as exc:
print(f"Job info not available: {exc}")
print("exercised: conferences.list_upcoming / conferencelists.get / meetups.list_by_country / books.list / tools.list_dev / jobinfos.get")
Get upcoming Bitcoin-only conferences. Returns a list of conferences with name, URL, location, and dates. The site is statically curated so the list reflects whatever the maintainer has published; it may include events whose dates have passed if the page hasn't been updated.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of conference objects each with name, url, location, and dates"
},
"sample": {
"data": {
"items": [
{
"url": "https://braiins.com/bitcoin-mining-conference-2022",
"name": "The Bitcoin Mining Conference",
"dates": "2022 / June / 14th-16th",
"location": "Prague / CZ"
}
]
},
"status": "success"
}
}About the Bitcoin-Only API
Conferences and Meetups
The API provides three conference endpoints: get_upcoming_conferences returns events with name, URL, location, and dates; get_past_conferences returns historical events where location and dates may be null; and get_all_conferences combines both in a single response grouped under upcoming and past arrays. For community gatherings, get_meatspace_meetups returns in-person meetup data worldwide with country, region, city, city_url, organizer, and organizer_url fields. The get_meetups_by_country endpoint accepts a country string parameter using case-insensitive substring matching, so values like 'USA', 'United Kingdom', or 'Germany' all work without exact formatting.
Learning, Media, and Tools
Several endpoints cover educational content. get_books returns books with category, title, author, and author_url. get_learning_resources covers articles, periodicals, classes, and websites. get_podcasts organizes podcasts by language, and get_videos covers tutorials and films by category. Each of these returns a name_url field linking directly to the resource. get_dev_tools surfaces libraries and developer learning resources organized by category, useful for building Bitcoin applications.
Wallets, Hardware, and Spending
get_wallets returns software wallet options segmented by category (on-chain, lightning, custodial, advanced). get_hardware_wallets covers physical devices and nodes. For the merchant side, get_spend_bitcoin lists merchants, services, stores, and games, while get_store_tools covers payment processing integrations for merchants accepting Bitcoin. get_get_bitcoin covers acquisition services including exchanges, earning platforms, and cashback rewards.
Privacy and Explorer Tools
get_privacy_tools returns CoinJoin implementations, communication tools, and informational resources — each with category, name, name_url, and description. get_explorers_dashboards covers blockchain explorers, fee estimators, and metrics dashboards. The get_jobs endpoint does not return job listings directly; it returns a redirect message pointing to bitcoinerjobs.com along with redirect_url and redirect_text fields.
The Bitcoin-Only API is a managed, monitored endpoint for bitcoin-only.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when bitcoin-only.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official bitcoin-only.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Bitcoin event calendar by combining
get_upcoming_conferencesandget_meatspace_meetupsdata filtered by country. - Populate a wallet comparison tool using
get_walletsandget_hardware_walletswith category and description fields. - Aggregate a Bitcoin reading list app using
get_booksauthor data andget_learning_resourcesarticle links. - Create a podcast directory filtered by language using
get_podcastscategory and name_url fields. - Display a developer resource hub using
get_dev_toolsandget_explorers_dashboardsorganized by category. - Map Bitcoin community meetup density by country using
get_meatspace_meetupscountry and region fields. - Build a merchant directory for spending Bitcoin using
get_spend_bitcoincategory and description data.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does bitcoin-only.com have an official developer API?+
What does `get_meetups_by_country` return, and how does the country filter work?+
country, region, city, city_url, organizer, and organizer_url fields, filtered to entries where the country field contains the query string. The match is case-insensitive and substring-based, so 'UK', 'United Kingdom', or 'kingdom' would all match the same entries.Does the `get_jobs` endpoint return actual job listings?+
message, redirect_url, and redirect_text rather than job records. The API covers job redirect metadata only. You can fork it on Parse and revise to add an endpoint that queries bitcoinerjobs.com directly.Can I filter wallets, podcasts, or books by category?+
get_wallets, get_podcasts, and get_books each return all records with a category field included, so filtering must be done client-side on the response array. The API does not currently expose per-category query parameters for those endpoints. You can fork the API on Parse and revise it to add category-level filtering endpoints.How current is the data, and does the API support pagination?+
get_meatspace_meetups return all worldwide records at once.