ShelvesNI BIASHARA
data · instant art-search

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

paramdescription
qfree text over work title and artist (optional)
artistartist name text, e.g. Peter Paul Rubens (optional)
institutionholding institution name text, e.g. Cleveland Museum of Art (optional)
mediummedium text, e.g. Oil on canvas (optional)
min_transfersonly records with at least this many documented transfers (optional)
limitmax records to return (optional, default 25, max 60)
offsetrecords 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.

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 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 }

← all shelves