03DOCUMENTATION
Assets RWA Developer DocsSHIP
SHIP
WALLET DATA
This app tracks wallet-level portfolio, earn, and analytics into Supabase through server-side routes. Use the flows below to sync data and read it in your pages.
Database
4
Core tables deployed
API Routes
4
Wallet-scoped endpoints
Auth Model
Srv
Service role on server only
Data Scope
30D
Daily analytics window
04QUICKSTART FLOW
01
Connect Wallet
Use the nav connect button. Wallet address becomes the data key.
02
POST Snapshots
Send portfolio, earn, and analytics payloads to wallet endpoints.
03
Read Dashboard
Call analytics GET endpoint to retrieve the combined dashboard bundle.
04
Render Pages
Portfolio / Earn / Analytics pages consume these rows in styled cards.
05ENDPOINTS
POST
/api/wallet/:address/portfolio
Save portfolio snapshot (value + holdings)
POST
/api/wallet/:address/earn
Upsert earn position (protocol, asset, amount, apy)
POST
/api/wallet/:address/analytics
Upsert daily analytics row (tx, volume, pnl, fees)
GET
/api/wallet/:address/analytics
Fetch wallet dashboard bundle (portfolio, earn, analytics)
06DATABASE TABLES
wallets
Master wallet records keyed by address.
portfolio_snapshots
Time-series portfolio values and holdings json payload.
earn_positions
Current earn allocations per protocol + asset.
analytics_daily
Daily wallet metrics for activity and performance.