Attic

Current Attic connector status: API version, the weekly as-of date, the four markets, and the 14 pillars. Call this first when the user asks what week the reports cover.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the four Attic collector markets (rare coins, sports cards, collector cars, fine art) with Headlines, Beyond, and Creators page URLs on atticcapital.com. Use this when you need the canonical page to link, not a top-5 roster.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the 14 locked report pillars in order (Collectors through Insights In Depth). Use the slug with attic_get_market_report. This does not return the ranked names.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get one weekly top-5 roster for a market, layer, and pillar. Use this for 'top 5', 'who is in the report', or a Headlines / Beyond pillar. For the paragraph on one rank, call attic_get_report_entry. For a name across pillars, use attic_search. layer=beyond is Attic Beyond and needs an API key.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "minLength": 1,
      "description": "Market: rare-coins, sports-cards, collector-cars, or art. Names such as Rare Coins or fine art are accepted."
    },
    "layer": {
      "type": "string",
      "minLength": 1,
      "description": "headlines (public weekly top 5) or beyond (Attic Beyond, paid)."
    },
    "pillar": {
      "type": "string",
      "minLength": 1,
      "description": "Pillar slug or name. Slugs: collectors, the-objects, houses, price-indexes, gatherings, brands-of-influence, wealth-transfer, asset-based-lending, authentication, infrastructure, independent-appraisers, forgery-fakes-scandal, the-numbers, insights-in-depth."
    }
  },
  "required": [
    "market",
    "layer",
    "pillar"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get one ranked name from a weekly pillar pack, with its summary and a short expanded excerpt. Requires market, layer, and pillar. rank is 1-5 and defaults to 1. The excerpt is not the whole page. layer=beyond is Attic Beyond.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "minLength": 1,
      "description": "Market: rare-coins, sports-cards, collector-cars, or art. Names such as Rare Coins or fine art are accepted."
    },
    "layer": {
      "type": "string",
      "minLength": 1,
      "description": "headlines (public weekly top 5) or beyond (Attic Beyond, paid)."
    },
    "pillar": {
      "type": "string",
      "minLength": 1,
      "description": "Pillar slug or name. Slugs: collectors, the-objects, houses, price-indexes, gatherings, brands-of-influence, wealth-transfer, asset-based-lending, authentication, infrastructure, independent-appraisers, forgery-fakes-scandal, the-numbers, insights-in-depth."
    },
    "rank": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Rank from 1 to 5. Defaults to 1."
    }
  },
  "required": [
    "market",
    "layer",
    "pillar"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Keyword search across roster names, summaries, and expanded report copy. The parameter is query (not q). This does not search articles or episodes. Optional market and layer filters. layer=beyond is Attic Beyond. Use attic_list_articles for the article archive.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Keywords, at least 2 characters. Sent as the query parameter."
    },
    "market": {
      "type": "string",
      "minLength": 1,
      "description": "Optional market filter."
    },
    "layer": {
      "type": "string",
      "minLength": 1,
      "description": "Optional layer filter. Omit to search the public index."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "How many hits to return. Default 8, max 20."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List shows, auctions, and other gatherings on the Attic calendar. Optional market filter. Public. This is the calendar, not the Gatherings pillar of the weekly report (use attic_get_market_report with pillar gatherings for that top 5).

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "minLength": 1,
      "description": "Optional market filter."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "How many gatherings. Default 12, max 40."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ledger of roster and gathering moves since the prior weekly cut. Use this for 'what changed', rank moves, names that entered or left a top 5. Optional since (YYYY-MM-DD), market, and layer. layer=beyond is Attic Beyond. An empty list means the rosters did not move.

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "description": "Optional prior date, YYYY-MM-DD. Omit for the retained previous cut."
    },
    "market": {
      "type": "string",
      "minLength": 1,
      "description": "Market: rare-coins, sports-cards, collector-cars, or art. Names such as Rare Coins or fine art are accepted."
    },
    "layer": {
      "type": "string",
      "minLength": 1,
      "description": "headlines is public. beyond is Attic Beyond."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List published atticcapital.com articles: title, date, URL, and a short excerpt. Never the full body. Optional q matches title, slug, and excerpt. Optional market (rare-coins, sports-cards, collector-cars, art, or other) and since (YYYY-MM-DD). Newest first.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Optional keyword over title, slug, and excerpt."
    },
    "market": {
      "type": "string",
      "description": "Optional market: rare-coins, sports-cards, collector-cars, art, fine-art, or other."
    },
    "since": {
      "type": "string",
      "description": "Keep articles published on or after this YYYY-MM-DD date."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Default 8, max 20."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Skip this many articles. Default 0."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get one atticcapital.com article by WordPress slug: title, date, excerpt, markets, dossier slugs, and episode numbers. The excerpt is a summary of at most 400 characters. Do not fetch the article HTML.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Article slug, such as nolan-ryan. From attic_list_articles."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List Creators & Cultural Icons podcast episodes (public): number, title, date, summary, show-notes URL, and audio URL. Optional q searches title, slug, and summary. Optional market filters the mapped collection. Newest episode number first.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Optional keyword over title, slug, and summary."
    },
    "market": {
      "type": "string",
      "minLength": 1,
      "description": "Optional market filter."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Default 8, max 20."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Skip this many episodes."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get one Creators episode by episode number or slug. Prefer episode when you have the number. Returns the summary, show notes on atticcapital.com, collection, and audio URL. Public.

{
  "type": "object",
  "properties": {
    "episode": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Episode number. Preferred over slug."
    },
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Episode slug if you do not have the number."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get an Attic object dossier by market and slug: thesis, risk flags, related Creators episodes, and outbound links. About 38 Creators-grounded briefs. Slugs appear on articles and episodes. Attic Beyond: needs an API key. Unknown slugs 404. Do not invent a dossier.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "minLength": 1,
      "description": "Market: rare-coins, sports-cards, collector-cars, or art. Names such as Rare Coins or fine art are accepted."
    },
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Dossier slug from an article or episode, such as a Creators object slug."
    }
  },
  "required": [
    "market",
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Attic Market Strength composites for rare coins, sports cards, collector cars, and fine art. Week-0 levels are 100 until scored inputs exist. Peer feeds may be stub_until_licensed. Omit market for the full package. Attic Beyond: needs an API key. Do not invent index levels. This is not the Price Indexes pillar of the weekly report.

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "minLength": 1,
      "description": "Optional market. Index slugs are rare-coin, sports-card, collector-car, and art. Plural report slugs are accepted."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Whether PSA cert lookup and the eBay-sold bridge are configured or live. No upstream price call. PCGS comps are not offered. If live is false, do not quote sold prices or grades. Public.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

STUB. Does not return a PSA grade or population. PCGS comps are not offered. Do not call this to answer what a card graded or sold for. Requires an Attic API key; without one, the tool explains Attic Beyond. Never invent a cert result.

{
  "type": "object",
  "properties": {
    "cert": {
      "type": "string",
      "minLength": 1,
      "description": "PSA certification number. The live lookup is not enabled."
    }
  },
  "required": [
    "cert"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

STUB. Does not return eBay sold prices for sports cards. Do not call this to price a card, and do not invent a hammer or a sold comp. Requires an Attic API key. PCGS is unrelated and is not offered.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "description": "Card keywords. No sold prices are returned while this route is a stub."
    },
    "category": {
      "type": "string",
      "enum": [
        "cards",
        "coins",
        "any"
      ],
      "description": "Defaults to the card route."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "description": "Lookback in days. Default 30."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Default 10, max 25."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

STUB. Does not return sold prices for coins. Do not call this to price a coin, and do not invent a hammer. Requires an Attic API key. PCGS comps are not offered.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "description": "Coin keywords. No sold prices are returned while this route is a stub."
    },
    "category": {
      "type": "string",
      "enum": [
        "cards",
        "coins",
        "any"
      ],
      "description": "Defaults to coins on this route."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "description": "Lookback in days. Default 30."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Default 10, max 25."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}