Announcing the Paragraph API & SDK — Paragraph

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.

What you can do with the API & SDK

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:

• API reference
• TypeScript SDK
• Developer FAQ & documentation

A first example: Paragraph Markets

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.

How can we make the API & SDK better for you?

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.