{"openapi":"3.1.0","info":{"title":"Lithium Research Vault","version":"vault-v1","description":"Primary-source data on lithium & battery-metals mining companies and mines. Every numeric value is extracted from a regulator filing (SEC, ASX, TSX, SEDAR, cninfo) or IR document and FX-normalized to USD with the source URL attached. Coverage is industry-wide: hardrock (spodumene/lepidolite) + brine producers AND DFS-stage developers (e.g. Cinovec, Manna, Bandeira, Shaakichiuwaanaan) — for developers the data includes feasibility-study economics (NPV, IRR, capex, AISC).","x-guidance":"Sells primary-source lithium-sector data sourced entirely from a curated, filing-cited vault (no live web scraping). Three paid tiers, all taking ?entity=<X>&level=<company|mine>, cheapest first: GET /vault/summary ($0.02) returns a one-row headline digest (latest production, volume-weighted AISC, cash/debt/EBITDA, reserves, top holder, source URL); GET /vault ($0.05) returns the full structured extract (every period of financials/production/AISC/ownership/royalties/offtakes + developer DFS economics + market cap & lithium spot + 30 recent filings); GET /vault/comparables ($0.20) ranks the entity against the whole tracked universe — AISC cost-curve percentile, resource-size rank, balance-sheet survival rank — every figure cited. level=company uses exchange tickers — producers (SGML, ALB, PILBF, ATUSF) and developers (EMH/Cinovec, GL1/Manna, PMETF, LTH); level=mine uses mine names — producing (Greenbushes, Pilgangoora, Grota do Cirilo, Wodgina, Atacama) or DFS-stage developer (Cinovec, Manna, Bandeira, Shaakichiuwaanaan) — aggregating all operators. Unknown entities return 400 before payment (no charge). One entity per call — fan out N calls for multiple. Free preview: GET /vault/example returns a live sample with no payment. GET / (Accept: application/json) lists every covered company and mine.","contact":{"name":"clink","url":"https://clink-lithium-vault.fly.dev"}},"servers":[{"url":"https://clink-lithium-vault.fly.dev"}],"paths":{"/vault/summary":{"get":{"operationId":"vaultSummary","summary":"Headline snapshot for one lithium company or mine ($0.02)","description":"Slim single-row digest: latest production, volume-weighted AISC, realized price, cash/debt/EBITDA/FCF, reserves, top institutional holder, and the primary source filing URL. Cheapest tier — for fast scans and portfolio rollups.","tags":["Lithium data"],"parameters":[{"name":"entity","in":"query","required":true,"description":"Company ticker (level=company) or mine/asset name (level=mine), case-insensitive. Tickers are SEC/ASX/TSX symbols — producers (SGML, ALB, PILBF, ATUSF) and DFS-stage developers (EMH, GL1, PMETF, LTH, ATLX). Mine names are as listed in the producer/developer reference, e.g. producing: Greenbushes, Pilgangoora, Grota do Cirilo, Wodgina, Atacama; developers: Cinovec, Manna, Bandeira, Shaakichiuwaanaan.","schema":{"type":"string","minLength":2,"examples":["SGML","Greenbushes"]}},{"name":"level","in":"query","required":true,"description":"company → operator-level rows for one ticker; mine → asset-level rows aggregated across every operator of that mine (e.g. Greenbushes returns IGO + ALB + TIANQI).","schema":{"type":"string","enum":["company","mine"],"examples":["company"]}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Headline digest for the requested entity.","content":{"application/json":{"schema":{"type":"object","description":"Slim single-row headline digest. Shape differs slightly between company and mine level; null-safe (missing values are null, never absent).","properties":{"meta":{"type":"object","description":"Response envelope metadata.","properties":{"version":{"type":"string","const":"vault-v1"},"level":{"type":"string","enum":["company","mine"]},"kind":{"type":"string","enum":["summary","raw","comparables"]},"entity":{"type":"string"},"asOf":{"type":"string","description":"ISO timestamp of response generation."},"cacheHit":{"type":"boolean"},"pricing":{"type":"object","properties":{"perCallUsd":{"type":"number"}}}},"required":["version","level","kind","entity"]},"ticker":{"type":["string","null"],"description":"company level only"},"company_name":{"type":["string","null"]},"asset_name":{"type":["string","null"],"description":"mine level only"},"latest_period":{"type":["string","null"]},"cash_usd_m":{"type":["number","null"]},"total_debt_usd_m":{"type":["number","null"]},"production_latest_kt_100pct":{"type":["number","null"]},"aisc_latest_usd_per_t_volume_weighted":{"type":["number","null"]},"total_resource_mt":{"type":["number","null"]},"top_institutional_holder":{"type":["object","null"]},"primary_source_url":{"type":["string","null"],"description":"primary filing the headline figures cite."}},"required":["meta"],"additionalProperties":true}}}},"400":{"description":"entity_not_in_vault / missing or invalid params. Returned BEFORE payment — the caller is never charged."},"402":{"description":"Payment Required — pay the x402 challenge in USDC on Base, then retry."}}}},"/vault":{"get":{"operationId":"vaultRaw","summary":"Full structured vault extract for one lithium company or mine ($0.05)","description":"Complete structured JSON straight from the vault: every period of financials, production, AISC, mine economics, reserves, full ownership history, royalties, offtakes, and the 30 most recent filings. Mine level aggregates rows across every operator. Deterministic, no LLM. Every figure FX-normalized to USD and cited to a primary filing.","tags":["Lithium data"],"parameters":[{"name":"entity","in":"query","required":true,"description":"Company ticker (level=company) or mine/asset name (level=mine), case-insensitive. Tickers are SEC/ASX/TSX symbols — producers (SGML, ALB, PILBF, ATUSF) and DFS-stage developers (EMH, GL1, PMETF, LTH, ATLX). Mine names are as listed in the producer/developer reference, e.g. producing: Greenbushes, Pilgangoora, Grota do Cirilo, Wodgina, Atacama; developers: Cinovec, Manna, Bandeira, Shaakichiuwaanaan.","schema":{"type":"string","minLength":2,"examples":["SGML","Greenbushes"]}},{"name":"level","in":"query","required":true,"description":"company → operator-level rows for one ticker; mine → asset-level rows aggregated across every operator of that mine (e.g. Greenbushes returns IGO + ALB + TIANQI).","schema":{"type":"string","enum":["company","mine"],"examples":["company"]}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Full structured extract for the requested entity.","content":{"application/json":{"schema":{"type":"object","description":"Full structured extract. Company level returns the keys below; mine level returns { meta, asset_name, operators[], production[], mine_financials[], royalties[], offtakes[] } aggregated across operators. Every row that has a source carries source_url.","properties":{"meta":{"type":"object","description":"Response envelope metadata.","properties":{"version":{"type":"string","const":"vault-v1"},"level":{"type":"string","enum":["company","mine"]},"kind":{"type":"string","enum":["summary","raw","comparables"]},"entity":{"type":"string"},"asOf":{"type":"string","description":"ISO timestamp of response generation."},"cacheHit":{"type":"boolean"},"pricing":{"type":"object","properties":{"perCallUsd":{"type":"number"}}}},"required":["version","level","kind","entity"]},"company":{"type":"object","description":"Company metadata (ticker, name, exchanges, stage, HQ, etc.)."},"assets":{"type":"array","items":{"type":"object"},"description":"Per-mine asset rows owned by this company."},"financials":{"type":"array","items":{"type":"object"},"description":"Corporate-level periods, USD-normalized."},"production":{"type":"array","items":{"type":"object"},"description":"Per-mine per-period volume + AISC + realized price."},"mine_financials":{"type":"array","items":{"type":"object"}},"ownership":{"type":"array","items":{"type":"object"},"description":"Top holders + filing-date history."},"royalties":{"type":"array","items":{"type":"object"}},"offtakes":{"type":"array","items":{"type":"object"}},"project_economics":{"type":"array","items":{"type":"object"},"description":"Forward-looking study economics (NPV/IRR/payback/capex) per scenario."},"development":{"type":"array","items":{"type":"object"},"description":"Permitting / FID / construction / first-production path per asset."},"market":{"type":"object","description":"Latest equity close + computed market cap + latest lithium spot prints (with licensing disclaimer)."},"recent_filings":{"type":"array","items":{"type":"object"},"description":"Newest 30 filings with derived titles + tags."}},"required":["meta"],"additionalProperties":true}}}},"400":{"description":"entity_not_in_vault / missing or invalid params. Returned BEFORE payment — the caller is never charged."},"402":{"description":"Payment Required — pay the x402 challenge in USDC on Base, then retry."}}}},"/vault/comparables":{"get":{"operationId":"vaultComparables","summary":"Cost-curve + peer ranking vs the whole lithium universe ($0.20)","description":"Ranks one entity against EVERY tracked lithium mine: AISC cost-curve percentile (who survives the downcycle), resource-size rank, and balance-sheet net-cash survival rank. Dataset-level analysis a single-entity call can't reproduce. Pure deterministic SQL — no LLM. Every figure cited to a SEC/ASX/TSX filing.","tags":["Lithium data"],"parameters":[{"name":"entity","in":"query","required":true,"description":"Company ticker (level=company) or mine/asset name (level=mine), case-insensitive. Tickers are SEC/ASX/TSX symbols — producers (SGML, ALB, PILBF, ATUSF) and DFS-stage developers (EMH, GL1, PMETF, LTH, ATLX). Mine names are as listed in the producer/developer reference, e.g. producing: Greenbushes, Pilgangoora, Grota do Cirilo, Wodgina, Atacama; developers: Cinovec, Manna, Bandeira, Shaakichiuwaanaan.","schema":{"type":"string","minLength":2,"examples":["SGML","Greenbushes"]}},{"name":"level","in":"query","required":true,"description":"company → operator-level rows for one ticker; mine → asset-level rows aggregated across every operator of that mine (e.g. Greenbushes returns IGO + ALB + TIANQI).","schema":{"type":"string","enum":["company","mine"],"examples":["company"]}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.200000"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Universe-relative ranking for the requested entity.","content":{"application/json":{"schema":{"type":"object","description":"Dataset-level ranking of one entity against the ENTIRE tracked lithium-mine universe. Pure SQL/JS over the vault — no LLM. Every figure carries a source_url. cost_curve gives the AISC percentile + nearest peers; resource_rank the endowment percentile; balance_sheet (company level) the net-cash survival rank.","properties":{"meta":{"type":"object","description":"Response envelope metadata.","properties":{"version":{"type":"string","const":"vault-v1"},"level":{"type":"string","enum":["company","mine"]},"kind":{"type":"string","enum":["summary","raw","comparables"]},"entity":{"type":"string"},"asOf":{"type":"string","description":"ISO timestamp of response generation."},"cacheHit":{"type":"boolean"},"pricing":{"type":"object","properties":{"perCallUsd":{"type":"number"}}}},"required":["version","level","kind","entity"]},"comparables":{"type":"object","properties":{"entity":{"type":"string"},"level":{"type":"string","enum":["company","mine"]},"methodology":{"type":"string"},"cost_curve":{"type":"object","description":"Latest unit cost (AISC > brine implied LCE cost > cash cost) ranked across all tracked mines; lower percentile = cheaper = more resilient."},"resource_rank":{"type":"object","description":"Resource-size (Mt) rank across the universe."},"balance_sheet":{"type":["object","null"],"description":"Company level only: net-cash survival rank vs peers."},"citations":{"type":"array","items":{"type":"object"}}},"required":["entity","level","cost_curve"]}},"required":["meta","comparables"],"additionalProperties":true}}}},"400":{"description":"entity_not_in_vault / missing or invalid params. Returned BEFORE payment — the caller is never charged."},"402":{"description":"Payment Required — pay the x402 challenge in USDC on Base, then retry."}}}},"/vault/example":{"get":{"operationId":"vaultExample","summary":"Free live sample of the vault data shape (no payment)","description":"Returns a live summary-tier payload for a sample company (SGML) plus a description of all three paid tiers. No x402 payment required — lets agents see the real data shape before buying.","tags":["Lithium data"],"security":[],"responses":{"200":{"description":"Free sample payload.","content":{"application/json":{"schema":{"type":"object","description":"Slim single-row headline digest. Shape differs slightly between company and mine level; null-safe (missing values are null, never absent).","properties":{"meta":{"type":"object","description":"Response envelope metadata.","properties":{"version":{"type":"string","const":"vault-v1"},"level":{"type":"string","enum":["company","mine"]},"kind":{"type":"string","enum":["summary","raw","comparables"]},"entity":{"type":"string"},"asOf":{"type":"string","description":"ISO timestamp of response generation."},"cacheHit":{"type":"boolean"},"pricing":{"type":"object","properties":{"perCallUsd":{"type":"number"}}}},"required":["version","level","kind","entity"]},"ticker":{"type":["string","null"],"description":"company level only"},"company_name":{"type":["string","null"]},"asset_name":{"type":["string","null"],"description":"mine level only"},"latest_period":{"type":["string","null"]},"cash_usd_m":{"type":["number","null"]},"total_debt_usd_m":{"type":["number","null"]},"production_latest_kt_100pct":{"type":["number","null"]},"aisc_latest_usd_per_t_volume_weighted":{"type":["number","null"]},"total_resource_mt":{"type":["number","null"]},"top_institutional_holder":{"type":["object","null"]},"primary_source_url":{"type":["string","null"],"description":"primary filing the headline figures cite."}},"required":["meta"],"additionalProperties":true}}}}}}}}}