ShelvesNI BIASHARA
data · instant recipes-single

One complete recipe record

One complete recipe record from the Ni Biashara recipes shelf: ingredients with quantities and units, timed steps, substitutions that work, sourcing notes and pairing. Query by record id or exact dish title.

$0.10 per call — paid in USDC on Base over the x402 protocol, settled by Coinbase. No API key, no signup.

Parameters

paramdescription
titledish title, exact or close match (this or id required)
idrecipe record id, e.g. kenyan-beef-pilau (this or title required)

Call it (any x402 client)

# 1. GET without payment → HTTP 402 with PAYMENT-REQUIRED (price, payTo, scheme "exact")
curl -i "https://agents.nibiashara.biz/shelf/recipes-single?title=&id="

# 2. Sign the payment (EIP-3009 transferWithAuthorization, gasless) and retry
#    with the PAYMENT-SIGNATURE header → response body is the delivery.

With the official JS client the whole flow is one wrapped fetch:

import { wrapFetchWithPayment } from "@x402/fetch";       // npm i @x402/fetch @x402/evm
const fetchPaid = wrapFetchWithPayment(fetch, { /* your EVM signer */ });
const res = await fetchPaid("https://agents.nibiashara.biz/shelf/recipes-single?title=&id=");
const data = await res.json();

Or install the MCP server (https://agents.nibiashara.biz/mcp, registry id biz.nibiashara/shelves) and use the job-named tool for this shelf, or buy_shelf as an escape hatch.

Calling this repeatedly? Buy a Shelf Pass once ($0.99 for 110 credits) and send X-SHELF-PASS: <token> instead of paying per call — this shelf costs 10 credits per call.

Example response (illustrative shape, not a live rate)

{
  "shelf": "recipes-single",
  "query": {},
  "source": "Ni Biashara recipes shelf — traditional preparations with standardised, cookable quantities, written and checked per record (see each record's source field)",
  "as_of": "2026-11-20",
  "publisher": "Ni Biashara",
  "canonical_url": "https://nibiashara.biz/shelf/recipes-single",
  "license": "https://nibiashara.biz/terms#data-license",
  "found": false,
  "recipe": null,
  "note": "No recipe record under that id/title in the current snapshot. Absence means 'not on the shelf yet', not 'the dish does not exist' — the shelf grows through the daily depth pass.",
  "illustrative": true
}

Delivers

JSON { found, recipe record or null, note when not found, source, as_of }

← all shelves