
One of the big benefits of building onchain is the excitement for interoperability and building on top of each other's products.
Over the past few years, we've heard developers ask for ways to build new tools experiences on top of Paragraph. We've also heard from writers looking for ways to streamline workflows or manage their publication more effectively.
Today we’re excited to make all those things a little easier with the Paragraph API and SDK.
We hope the API & SDK help developers build:
New & unique experiences for reading (and beyond, to other mediums)
Better ways to publish and manage your subscriber list
Ways for readers to discover new voices and great writing
Features that drive commerce between readers & writers
Below are more details on the functionality of the API & SDK, a trading app we built to showcase its capabilities, and ideas for where the API & SDK may go in the future.
The API and SDK expose a growing set of read and write operations across Paragraph. Here are the things developers can do and why they matter.
Fetch publication and post data: Access everything you need to build unique reading experiences, search and discovery layers, or a custom site for your publication. Fetch posts from any publication on Paragraph, or fetch posts from our most popular feed.
Access writer coins and post coins: Retrieve coin metadata, contract addresses, current price, market quotes, holders & more. Use this to power marketplaces, discovery platforms, or features that let readers support writers.
Execute market flows: Wire up buy and sell flows for writer and post coins, including wallet integration, transaction signing, and order handling. Use this to add commerce to your app or prototype a marketplace quickly.
Work with users and publications: Get user profiles by wallet, publication details, subscriber counts, and other stateful information. Use these endpoints to build publisher tools, automate workflows, or create custom dashboards.
Build custom frontends and integrations: Combine read and write endpoints to create analytics dashboards, discovery tools, social integrations, or editor workflows.
Integrate Paragraph into your product: Let readers subscribe to a publication, read posts, or buy writer coins directly inside your app or website.
A few examples for what's possible:
Add subscribers to your Paragraph newsletter directly from your own website
Build your own CMS using Obsidian, Wordpress, Ghost & more, and automatically publish the resulting posts to Paragraph
Fetch all subscribers to your newsletter and export them to a CSV to perform your own analysis on your newsletter's growth
Below are a few resources to make sure you get the most out of the API and SDK:
To show what’s possible, we built a small but fully functional & open source example app: Paragraph Markets.
It’s a simple app where anyone can buy and sell writer coins and post coins from Paragraph publications. This showcases a fundamentally different frontend to Paragraph data: one that's anchored around trading (while also serving as a reference implementation to show how the Paragraph API & SDK can be used).
A few things Paragraph Markets showcases:
Fetching market data for writer coins
Displaying price changes over time
Showing publication metadata and profiles
Executing onchain buy and sell flows
Stitching everything together into a clean, minimal UI
And because we want this to be a learning tool, the entire repo is open source: https://github.com/paragraph-xyz/markets.
Feel free to fork it, copy pieces of it, or treat it as a starting point for your own experiments.
We built the API and SDK to empower developers, writers, and readers to build whatever they can imagine and to solve their particular problems. We would love to continue improving and expanding the functionality of these tools with your input.
If you use the API or SDK, let us know:
What’s missing?
What’s confusing?
How could we make it easier to build on Paragraph?
Send a note to hello@paragraph.com or drop a comment below. We'd love to know what you're building and how we can make Paragraph the best place for writers, readers, and developers.
Share Dialog
thank goooo
Done
FINALLYYYYYYYY
oh god, thanks FINALLY
great
Lovely to see such growth on the paragraph. Happy to be a part of this journey
So does this mean I can build a website and have my paragraph posts embed as posts on the website that style like the website? If yes, will elements like subscribe buttons, support buttons, comments?
New on Paragraph: introducing the Paragraph API & typescript SDK. We're making it easier for developers to tap into the Paragraph ecosystem to consume, discover, publish & trade. And, we're open-sourcing our first reference app: Paragraph Markets, a trading interface built on top of writer coins: https://paragraph.markets Read more: https://paragraph.com/@blog/paragraph-api-and-sdk
awesome!!! congrats on this launch!!
awesome update!
Awesome! Plan to implement this asap: Add subscribers to your Paragraph newsletter directly from your own website
Awesome news and congrats 🥳
This is huge for paragraph Congrats Colin
Hi ser. Sent you a DM 🤝
Great development