Skip to content

Add Lithium Research Vault to ecosystem (Services/Endpoints)#182

Closed
ciinkwia wants to merge 1 commit into
coinbase:mainfrom
ciinkwia:add-lithium-research-vault
Closed

Add Lithium Research Vault to ecosystem (Services/Endpoints)#182
ciinkwia wants to merge 1 commit into
coinbase:mainfrom
ciinkwia:add-lithium-research-vault

Conversation

@ciinkwia
Copy link
Copy Markdown

What this adds

Lithium Research Vault — two x402-payable endpoints serving structured
lithium mine + operator data from a curated primary-source corpus (SEC, ASX,
TSX, SEDAR, cninfo, and IR filings). Running on Base mainnet since 2026-05-21.

Category: Services/Endpoints

Endpoints

Name Endpoint Price Network
Vault — raw data GET /vault $0.05 USDC Base
Vault — narrative synthesis GET /vault/story $0.20 USDC Base

Both accept ?entity=<TICKER|MineName>&level=<company|mine> and resolve
multi-operator mines (e.g., Greenbushes → IGO + ALB + TIANQI rows).

Live URL: https://clink-lithium-vault.fly.dev
Current listing on agentic.market: https://agentic.market/services/clink-lithium-vault-fly-dev

Coverage (as of 2026-05-21)

  • 40 vault operators (38 with extracted financials)
  • 49 producing mines tracked across Hardrock-Producers + Brine-Producers reference lists
  • Every numeric value FX-normalized to USD at extraction time with source filing URL on every row

Technical details

  • Scheme: exact
  • Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
  • payTo: 0xB1eF5415E9D3695e16977B8be422AB7512F788C0
  • Refund-by-design: out-of-vault entities 400 before payment middleware
  • Response: typed JSON validated by Zod (vault-v1 schema)
  • Differentiator vs other paid lithium feeds: curated primary-source corpus, not a wrapper around free public APIs. Citation URL on every numeric value.

About the metadata.json in this PR

Added typescript/site/app/ecosystem/partners-data/lithium-research-vault/metadata.json. Logo not included — happy to follow up with a 168×168 PNG (or other preferred format/dimensions) in a follow-up commit on this PR, or you can use the service favicon at https://clink-lithium-vault.fly.dev/favicon.ico for now.

I've omitted logoUrl from metadata.json given no logo file exists yet — let me know if you'd prefer I add a placeholder reference and a logo file in the same PR.

@cb-heimdall
Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

@ciinkwia
Copy link
Copy Markdown
Author

Closing — I missed the repo-move note at the top of the README. Re-filing this against x402-foundation/x402 as that's where ecosystem PRs now land. Sorry for the noise!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

2 participants