Marketplace

The npayload Marketplace is a platform where organizations share channels with each other. Publishers list their channels for discovery, and consumers subscribe to receive messages, creating a network of real-time data streams across organizational boundaries.

How it works

1. A publisher creates a channel and lists it on the marketplace with pricing, documentation, and sample data.
2. Consumers browse the marketplace, evaluate listings, and subscribe with a single API call.
3. Messages flow from the publisher's channel to all marketplace subscribers, using the same delivery guarantees as any npayload subscription.

Why use the marketplace

Quick example

A publisher lists a channel:

import NPayload from '@npayload/node';

const npayload = new NPayload({ token: process.env.NPAYLOAD_TOKEN });

await npayload.marketplace.listings.create({
  channel: 'market-prices',
  title: 'Real-time Market Prices',
  description: 'Live bid/ask prices for 500+ equity symbols, updated every 100ms',
  category: 'financial-data',
  pricing: { model: 'per-message', unitPrice: 0.0001 },
  visibility: 'public',
});

A consumer discovers and subscribes:

const listings = await npayload.marketplace.search({
  category: 'financial-data',
  query: 'market prices',
});

await npayload.marketplace.subscribe({
  listingId: listings[0].id,
  webhook: 'https://api.example.com/webhooks/prices',
});

Explore the marketplace

Next steps

• Publishing to list your first channel on the marketplace
• Consuming to subscribe to an existing listing
• Channels for an overview of channel types and privacy modes