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
| param | description |
|---|---|
title | dish title, exact or close match (this or id required) |
id | recipe 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 }