AF
Developer Tool · x402 · early usage

Snapshot of every series, all countries

Snapshot of every series, all countries

by afriref.dev · discovered, not yet claimed by its owner · updated 2026-10-08

30d calls1
30d payers1
MethodGET
Outputjson

Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.

What it does

Snapshot of every series, all countries

Tags: reference-data · snapshot · bulk · africa · bazaar

Call contract

Method
GET
Input
query parameters
Output
json
Last paid call
2026-10-08
Input example from Bazaar metadata
{}
Output example
{
  "example": [
    {
      "country": "string",
      "series": [
        {
          "components": [
            {
              "name": null,
              "rate": null
            }
          ],
          "country": "string",
          "effective_from": "string",
          "effective_from_basis": "restatement",
          "effective_rate": 0,
          "last_confirmed": "string",
          "notes": "string",
          "series": "string",
          "source": {
            "name": "string",
            "url": "https://example.com"
          },
          "stale": true,
          "unit": "string",
          "value": null
        }
      ]
    }
  ],
  "type": "string"
}

Use with an agent

  1. Discover. Agents find this listing with GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP tool search_resources, or /discovery/resources.
  2. Inspect. Fetch /resources/40612.json for the price and payment options.
  3. Pay. Call GET https://afriref.dev/v1/all. The provider answers 402 with its payment requirements. An x402 client signs one of the options below and retries with PAYMENT-SIGNATURE.
  4. Execute. The provider returns 200 with the data. Agent Bazaar is not in the request path and never sees your payment.

For humans

You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.

Pricing & payment

Price
$0.02 / request
Protocol
x402 v2
Auth
No account or API key. Pay per request.
Networks
Base
Demand
1 calls · 1 unique payers in 30d (public x402 Bazaar data)

x402 payment requirements

SchemeNetworkAssetAmountPay toTimeout
exactBase
eip155:8453
USDC$0.020x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6300s
accepts[] (raw JSON)
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x1F0409ccD20A2fb497d4DeCeF4E17e9d0688FeA6",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "amountUsd": 0.02,
    "maxTimeoutSeconds": 300
  }
]

Schemas

Output schema (JSON Schema)
{
  "properties": {
    "example": {
      "description": "One entry per country, each with all its series values",
      "items": {
        "properties": {
          "country": {
            "description": "ISO 3166-1 alpha-2 country code",
            "type": "string"
          },
          "series": {
            "items": {
              "properties": {
                "components": {
                  "description": "Optional. Breakdown of a composite rate into its named statutory components (present only where applicable, e.g. Ghana VAT).",
                  "items": {
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "rate": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "name",
                      "rate"
                    ],
                    "type": "object"
                  },
                  "type": "array"
                },
                "country": {
                  "description": "ISO 3166-1 alpha-2 country code",
                  "type": "string"
                },
                "effective_from": {
                  "format": "date",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "effective_from_basis": {
                  "description": "Optional. Absent: effective_from is the date the value became the law (a genuine change point). 'restatement': effective_from is the date the value's CURRENT LEGAL BASIS took effect (a new tax code, an annual finance law) while the value itself is older and its true origin is not primary-verifiable — a verified floor, not a change. Do not read a restatement row as the value having changed on that date.",
                  "enum": [
                    "restatement"
                  ],
                  "type": "string"
                },
                "effective_rate": {
                  "description": "Optional. Combined effective rate where statutory levies stack on top of the standard rate (e.g. Ghana VAT 15% + NHIL 2.5% + GETFund 2.5% = 20%). Present only where it differs from value.",
                  "type": "number"
                },
                "last_confirmed": {
                  "description": "When this value was last verified against the official source",
                  "format": "date",
                  "type": "string"
                },
                "notes": {
                  "type": "string"
                },
                "series": {
                  "type": "string"
                },
                "source": {
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "url": {
                      "format": "uri",
                      "type": "string"
                    }
                  },
                  "required": [
                    "name",
                    "url"
                  ],
                  "type": "object"
                },
                "stale": {
                  "description": "True when past the expected update cycle — treat with caution",
                  "type": "boolean"
                },
                "unit": {
                  "type": "string"
                },
                "value": {
                  "description": "Number for rates/wages; array of {date,name} for holiday calendars"
                }
              },
              "required": [
                "country",
                "series",
                "value",
                "effective_from",
                "last_confirmed",
                "source",
                "stale"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "country",
          "series"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}
Example shape — generated from the schema, not a captured live response
{
  "example": [
    {
      "country": "string",
      "series": [
        {
          "components": [
            {
              "name": null,
              "rate": null
            }
          ],
          "country": "string",
          "effective_from": "string",
          "effective_from_basis": "restatement",
          "effective_rate": 0,
          "last_confirmed": "string",
          "notes": "string",
          "series": "string",
          "source": {
            "name": "string",
            "url": "https://example.com"
          },
          "stale": true,
          "unit": "string",
          "value": null
        }
      ]
    }
  ],
  "type": "string"
}

Examples

curl
curl -X GET 'https://afriref.dev/v1/all'
# -> 402 Payment Required; read PAYMENT-REQUIRED
# retry the identical request with PAYMENT-SIGNATURE
JavaScript
const res = await fetch("https://afriref.dev/v1/all", {
  "method": "GET"
});
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}
Python
import httpx
res = httpx.request("GET", "https://afriref.dev/v1/all")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Details

Provider
afriref.dev
Endpoint
https://afriref.dev/v1/all
Machine-readable
/resources/40612.json