Art provenance search
Filtered search over the Ni Biashara art provenance shelf: museum collection records with structured provenance chains, continuity grades and documented transfer counts. Filter by text, artist, holding institution, medium or a transfer-count floor. Prices are never estimated — the price layer is named as a gap per record.
$0.25 per call — paid in USDC on Base over the x402 protocol, settled by Coinbase. No API key, no signup.
Parameters
| param | description |
|---|---|
q | free text over work title and artist (optional) |
artist | artist name text, e.g. Peter Paul Rubens (optional) |
institution | holding institution name text, e.g. Cleveland Museum of Art (optional) |
medium | medium text, e.g. Oil on canvas (optional) |
min_transfers | only records with at least this many documented transfers (optional) |
limit | max records to return (optional, default 25, max 60) |
offset | records to skip (optional, default 0) |
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/art-search?q=&artist=&institution=&medium=&min_transfers=&limit=&offset="
# 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/art-search?q=&artist=&institution=&medium=&min_transfers=&limit=&offset=");
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.
X-SHELF-PASS: <token> instead of paying per call — this shelf costs 25 credits per call.Example response (illustrative shape, not a live rate)
{
"shelf": "art-search",
"publisher": "Ni Biashara",
"canonical_url": "https://nibiashara.biz/shelf/art-search",
"license": "https://nibiashara.biz/terms#data-license",
"query": {
"q": "rubens"
},
"count": 2,
"returned": 2,
"results": [
{
"record_id": "art-cma-1959.190",
"record_type": "museum_collection",
"artist": "Peter Paul Rubens (Flemish, 1577–1640)",
"work_title": "Diana and Her Nymphs Departing for the Hunt",
"work_date": "c. 1615",
"medium": "oil on canvas",
"dimensions": "Framed: 261 x 225 x 11 cm (102 3/4 x 88 9/16 x 4 5/16 in.); Unframed: 216 x 178.7 cm (85 1/16 x 70 3/8 in.)",
"holding_institution": {
"name": "Cleveland Museum of Art",
"city": "Cleveland, US"
},
"sale_venue": null,
"sale_date": null,
"price_realized": null,
"credit_line": "Leonard C. Hanna Jr. Fund",
"provenance_text": null,
"provenance_chain": [
{
"holder_text": "The Cleveland Museum of Art, Cleveland, Ohio",
"date_text": "1959-"
},
{
"holder_text": "(Rosenberg & Stiebel, New York, NY, sold to the Cleveland Museum of Art)",
"date_text": "1959"
},
{
"holder_text": "Édouard [1868-1949] and Germaine [1884-1975] de Rothschild, Chantilly, sold to Rosenberg & Stiebel through Robert Leclerc1",
"date_text": "1948-1959"
}
],
"provenance_signals": {
"continuity": "structured_chain",
"documented_transfers": 23,
"earliest_date_text": "1959-",
"latest_date_text": "Until 1784",
"has_provenance_text": true
},
"source": "Cleveland Museum of Art Open Access API (CC0)",
"source_url": "https://clevelandart.org/art/1959.190",
"fetched_at": "2026-11-20T10:45:00Z",
"as_of": "2026-11-20",
"enrichment_gaps": [
"price_realized: museum collection record — source publishes no sale price",
"sale_history: no auction/market transactions published by source"
],
"authenticity_resources": [
"ifar-provenance-research",
"art-loss-register",
"getty-provenance-index"
]
},
{
"record_id": "art-met-435696",
"record_type": "museum_collection",
"artist": "Henry Bone (1755–1834)",
"artist_nationality": "British",
"work_title": "Thomas Howard (1585–1646), Second Earl of Arundel, after Rubens",
"work_date": "1808",
"medium": "Enamel",
"dimensions": "7 1/4 x 5 3/4 in. (185 x 147 mm)",
"holding_institution": {
"name": "The Metropolitan Museum of Art",
"city": "New York, US"
},
"sale_venue": null,
"sale_date": null,
"price_realized": null,
"credit_line": "The Moses Lazarus Collection, Gift of Josephine and Sarah Lazarus, in memory of their father, 1888–95",
"accession_number": "95.14.82",
"provenance_text": null,
"provenance_chain": [],
"provenance_signals": {
"continuity": "credit_line_only",
"documented_transfers": 0,
"earliest_date_text": null,
"latest_date_text": null,
"has_provenance_text": false
},
"source": "Metropolitan Museum of Art Open Access API (CC0)",
"source_url": "https://www.metmuseum.org/art/collection/search/435696",
"fetched_at": "2026-11-20T10:45:00Z",
"as_of": "2026-11-20",
"enrichment_gaps": [
"provenance_chain: Met Open Access does not publish a provenance chain for this object — credit line is the only ownership signal in the record",
"price_realized: museum collection record — source publishes no sale price",
"sale_history: no auction/market transactions published by source"
],
"authenticity_resources": [
"ifar-provenance-research",
"art-loss-register",
"getty-provenance-index"
]
}
],
"source": "Ni Biashara art provenance shelf — Cleveland Museum of Art Open Access (CC0), Metropolitan Museum of Art Open Access, Art Institute of Chicago CC0 (see each record's source)",
"as_of": "2026-11-20",
"price_layer_note": "price_realized is null on every v1 record: no keyless route to auction price data exists (every major source is paywalled, login-walled or JS-walled — probed 2026-11-20). The gap is named per record in enrichment_gaps, never estimated.",
"cache": "Snapshot data — provenance snapshot as_of 2026-11-20; refreshed by the daily shelves-depth pass, not pulled live per call.",
"illustrative": true
}
Delivers
JSON { count, returned, results[] (record_id, work_title, artist, provenance_chain, provenance_signals, authenticity_resources, price_realized (null in v1, gap named)), price_layer_note, source, as_of }