{"id":48879753,"url":"https://github.com/paragraph-xyz/markets","last_synced_at":"2026-04-16T02:06:39.125Z","repository":{"id":329171212,"uuid":"1110729952","full_name":"paragraph-xyz/markets","owner":"paragraph-xyz","description":"Find, discover, \u0026 buy the best writer coins on Paragraph. Using the Paragraph API.","archived":false,"fork":false,"pushed_at":"2025-12-18T18:52:35.000Z","size":637,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-21T07:16:05.826Z","etag":null,"topics":["creator","creator-coins","cryptocurrency","markets","paragraph","trading"],"latest_commit_sha":null,"homepage":"https://paragraph.markets","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paragraph-xyz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-05T16:23:18.000Z","updated_at":"2025-12-18T18:52:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/paragraph-xyz/markets","commit_stats":null,"previous_names":["paragraph-xyz/markets"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/paragraph-xyz/markets","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paragraph-xyz%2Fmarkets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paragraph-xyz%2Fmarkets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paragraph-xyz%2Fmarkets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paragraph-xyz%2Fmarkets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paragraph-xyz","download_url":"https://codeload.github.com/paragraph-xyz/markets/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paragraph-xyz%2Fmarkets/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31867716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"online","status_checked_at":"2026-04-16T02:00:06.042Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["creator","creator-coins","cryptocurrency","markets","paragraph","trading"],"created_at":"2026-04-16T02:06:38.515Z","updated_at":"2026-04-16T02:06:39.111Z","avatar_url":"https://github.com/paragraph-xyz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Paragraph Markets\n\nA trading platform for [Paragraph](https://paragraph.com) writer coins, built to showcase the **Paragraph API and SDK**.\n\n**Live Demo:** [paragraph.markets](https://paragraph.markets)\n**API \u0026 SDK Docs:** [paragraph.com/docs](https://paragraph.com/docs)\n\n## What are Writer Coins?\n\nWriter coins are tokens on the [Base](https://base.org) network that represent ownership in a creator's work on Paragraph. Each writer on Paragraph can have their own coin that fans and supporters can buy and sell. There are two types:\n\n- **Writer Coins** — Tied to a specific creator's overall presence on Paragraph\n- **Post Coins** — Tied to individual posts or publications\n\nThese coins create a new way for readers to support writers and participate in their success.\n\n## About This Project\n\nParagraph Markets is both a functional trading platform and a **reference implementation** for developers looking to integrate the Paragraph SDK into their own applications. It demonstrates:\n\n- Fetching and displaying writer coins\n- Getting real-time price quotes\n- Executing buy and sell transactions\n- Displaying price charts and market data\n- Wallet integration on Base network\n\n## Tech Stack\n\n- **[Next.js 16](https://nextjs.org)** — React framework with App Router\n- **[Paragraph SDK](https://paragraph.com/docs)** — Core API for coins, quotes, and transactions\n- **[RainbowKit](https://rainbowkit.com) + [wagmi](https://wagmi.sh)** — Wallet connection\n- **[TanStack Query](https://tanstack.com/query)** — Data fetching and caching\n- **[Tailwind CSS v4](https://tailwindcss.com)** — Styling\n- **[lightweight-charts](https://tradingview.github.io/lightweight-charts/)** — Price charts\n\n## Getting Started\n\n### Prerequisites\n\n- [Bun](https://bun.sh) (recommended) or Node.js 18+\n- A [WalletConnect](https://cloud.walletconnect.com) project ID\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/paragraph-xyz/markets.git\ncd markets\n\n# Install dependencies\nbun install\n```\n\n### Environment Setup\n\nCreate a `.env.local` file in the root directory:\n\n```bash\nNEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID=your_walletconnect_project_id\n```\n\nYou can get a WalletConnect project ID for free at [cloud.walletconnect.com](https://cloud.walletconnect.com).\n\n### Development\n\n```bash\n# Start the development server\nbun run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) to view the app.\n\n### Build for Production\n\n```bash\n# Create production build\nbun run build\n\n# Start production server\nbun run start\n```\n\n### Linting\n\n```bash\n# Check for issues\nbun run lint\n\n# Auto-fix issues\nbun run lint:fix\n```\n\n## Project Structure\n\n```\nsrc/\n├── app/                    # Next.js App Router pages\n│   └── (main)/             # Main layout with parallel routes\n│       └── @sidebar/       # Trading sidebar (parallel route)\n├── components/\n│   ├── ui/                 # Base UI components (Radix primitives)\n│   ├── coins-grid.tsx      # Grid display of available coins\n│   ├── trade-sidebar.tsx   # Buy/sell trading interface\n│   ├── price-chart.tsx     # Candlestick/area charts\n│   └── providers.tsx       # Wagmi, RainbowKit, Query providers\n├── hooks/\n│   ├── use-paragraph.ts    # Paragraph SDK integration\n│   ├── use-eth-price.ts    # ETH/USD price fetching\n│   └── use-gecko-terminal.ts # OHLCV chart data\n└── lib/\n    └── utils.ts            # Utility functions\n```\n\n## Key Integration Points\n\n### Using the Paragraph SDK\n\nThe SDK is initialized and used in `src/hooks/use-paragraph.ts`:\n\n```typescript\nimport { ParagraphAPI } from \"@paragraph_xyz/sdk\";\n\nconst api = new ParagraphAPI();\n\n// Fetch popular coins\nconst coins = await api.getPopularCoins();\n\n// Get a quote for buying\nconst quote = await api.getCoinBuyQuote(coinAddress, amountInWei);\n\n// Execute a buy transaction (requires connected wallet)\nawait api.buyCoin({ address, amountIn, walletClient });\n```\n\n### Wallet Integration\n\nRainbowKit and wagmi are configured in `src/components/providers.tsx`. The app is configured for the Base network only.\n\n## Learn More\n\n- **[Paragraph SDK Documentation](https://paragraph.com/docs)** — Full API reference and guides\n- **[Paragraph](https://paragraph.com)** — The publishing platform\n- **[Base](https://base.org)** — The L2 network where writer coins live\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparagraph-xyz%2Fmarkets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparagraph-xyz%2Fmarkets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparagraph-xyz%2Fmarkets/lists"}