Africa’s Bitcoin ecosystem, one request away.

Your first request in a minute

No sign-up needed to browse. Open a terminal and follow along. For higher limits and bulk export, grab a free key from your dashboard.

1. Make your first request

   Ask for a few projects. Every list response has data (the results) and meta (limit and nextCursor).

   /api/v1/projects

   cURLJavaScriptPython

   curl "https://api.directory.bitcoiners.africa/api/v1/projects?limit=2"

2. Filter it down

   Add filters freely. Here: Lightning-accepting projects in Nigeria.

   /api/v1/projects

   cURLJavaScriptPython

   curl "https://api.directory.bitcoiners.africa/api/v1/projects?country=NG&lightning=true&limit=5"

3. Ask for the big picture

   /api/growth/overview returns the same quarterly numbers as the growth tracker.

   /api/growth/overview

   cURLJavaScriptPython

   curl "https://api.directory.bitcoiners.africa/api/growth/overview"

4. Page through everything

   Lists return up to 100 results at a time. Keep passing meta.nextCursor back as cursor until it comes back null.

   paginate.js

   let cursor = null;
   const all = [];
   
   do {
     const url = new URL("https://api.directory.bitcoiners.africa/api/v1/projects");
     url.searchParams.set("limit", "100");
     if (cursor) url.searchParams.set("cursor", cursor);
   
     const { data, meta } = await (await fetch(url)).json();
     all.push(...data);
     cursor = meta.nextCursor;
   } while (cursor);
   
   console.log(all.length, "projects");

Base URL & format

All public v1 requests go to one base URL over HTTPS. Responses are JSON. Growth endpoints live under /api/growth on the same host.

List endpoints wrap results in data and describe the page in meta. Pass meta.nextCursor back as cursor to fetch the next page.

Access & rate limits

Errors

Errors use standard HTTP status codes and return a short JSON body you can show or log.

{
  "success": false,
  "error": {
    "message": "Rate limit exceeded. Try again later.",
    "code": "RATE_LIMITED"
  }
}

The project object

Every project returned by /api/v1/projects has this shape. Founder contact details and owner user ids are never included.

Statuses

The public project API only returns listings that are approved and active. Growth snapshot entries use a separate status so quarterly history stays complete.

Directory data is available under CC-BY-4.0. Attribution: Data from the Bitcoin in Africa Directory (https://directory.bitcoiners.africa)

Coming next