Grapevine.fyi Docs
Grapevine lets developers monetize data through feeds and entries using micropayments on Base.
Perfect for:- 📊 API data feeds (market prices, analytics, etc.)
- 📰 Content subscriptions (articles, research, etc.)
- 🔗 Real-time data streams (IoT, sensors, etc.)
- 💰 Micropayments in USDC on Base
- 🔐 Wallet-based authentication
- 🎯 Multiple content formats (JSON, text, etc.)
Quick Links
- Quick Start - Get started in 5 minutes
- API Documentation - Complete REST API docs
- SDK - TypeScript SDK ✨ Ready to use!
- CLI - Command-line tool ✨ Ready to use!
Networks
| Environment | URL | Chain | Currency |
|---|---|---|---|
| Testnet | api.grapevine.markets | Base Sepolia (84532) | Test USDC |
| Mainnet | api.grapevine.fyi | Base (8453) | USDC |
Getting Started
Using the SDK (Recommended)
npm install @pinata/grapevine-sdkimport { GrapevineClient } from '@pinata/grapevine-sdk';
const grapevine = new GrapevineClient({
network: 'testnet',
privateKey: process.env.PRIVATE_KEY
});
// Create your data feed
const feed = await grapevine.feeds.create({
name: 'Market Data Feed',
description: 'Real-time crypto prices'
});
// Add JSON data entry
const dataEntry = await grapevine.entries.create(feed.id, {
content: { symbol: 'BTC', price: 42000, timestamp: Date.now() },
title: 'Bitcoin Price Update',
is_free: true
});
// Upload a PDF file (Node.js/Bun)
import { readFileSync } from 'fs';
const pdfBuffer = readFileSync('./report.pdf');
const paidEntry = await grapevine.entries.create(feed.id, {
content: pdfBuffer,
title: 'Premium Report',
mime_type: 'application/pdf',
is_free: false,
price: { amount: '1000000', currency: 'USDC' } // 1.00 USDC
});For React Apps (Wagmi)
import { useGrapevine, useGrapevineReady } from '@pinata/grapevine-sdk/react';
import { useWalletClient } from 'wagmi';
function App() {
const { data: walletClient } = useWalletClient();
// Address is automatically extracted from walletClient
const grapevine = useGrapevine({
walletClient,
network: 'testnet'
});
const isReady = useGrapevineReady(grapevine);
// Use grapevine client when ready...
}See the Quick Start guide for complete setup instructions.