App and notifications

v4 Marketplace runs as an app on Android and iPhone, with a hook leaderboard, a page per v4 hook, a follow list and notifications when a swap goes through a hook you follow.

Installing

On Android, download the APK from Get the app. It is a Trusted Web Activity: Chrome opens v4market.com full screen and checks the app's signing certificate against /.well-known/assetlinks.json, which is why there is no URL bar. The page lists the file size and its SHA-256 so you can check the download. The app is not on Google Play or the App Store.

On iPhone, open the site in Safari, tap Share, then Add to Home Screen. The installed app has its own icon, opens full screen and shows a bottom tab bar: Swaps, Hooks, Top, Following and Build. A service worker keeps the last screens and chain reads, so the app opens offline with the data it loaded last.

Leaderboard

The leaderboard ranks every listed v4 hook by the royalties it was paid, then by swaps, over 24 hours, 7 days or all time. A swap counts for a hook when it went through a pool whose hook stack holds that hook. Royalties come from the Royalty events of the hook stack and are priced with the Chainlink feed of each stock token, USDG at 1 USD.

Hook pages and share cards

Every v4 hook has a page at /app/hooks/<id>: swaps over 24 hours, 7 days and all time, royalties per token, its listing (royalty, gas limit, stake, failed runs, source), the pools running it and the last swaps through it. The page has its own OpenGraph image, drawn on request from the same chain reads, with swaps per day over the last 14 days. Post the link on X and the card shows the live figures.

Following and notifications

Follow any v4 hook from its page, the leaderboard or Following. The list lives in your browser. Turn notifications on and the browser gives the site a push endpoint; the site keeps that endpoint with your list of hook ids, and nothing else. After each hourly run the keeper calls the dispatcher, which reads the new Swapped and Royalty events since the last call and sends one note per followed hook that had swaps. Turn notifications off and the endpoint is deleted.

On iPhone, web push needs iOS 16.4 or later and works only from the app added to the home screen. On Android it works in Chrome and in the installed app.

Wallet activity

Wallet activity shows, for any address, the swaps it sent through hook stacks and the royalties it earned as a hook author, with the hooks it authored.

The activity API

The screens read one public endpoint, cached for 60 seconds:

curl https://v4market.com/api/activity              # leaderboard (24h, 7d, all) and the last 30 swaps
curl https://v4market.com/api/activity?hook=1       # one v4 hook: listing, windows, pools, last swaps
curl https://v4market.com/api/activity?hooks=1,4    # swaps through any of these hooks
curl https://v4market.com/api/activity?wallet=0x... # swaps made and royalties earned by a wallet