Marketplace Listing
Your marketplace listing is the storefront for your application. It is what users see when browsing the General Wisdom marketplace and determines whether they spend SMART tokens on a session.
Prerequisites
- A registered application in Draft or Approved state
- Owner, Admin, or Developer role in your organization
Accessing the Listing Editor
- Navigate to
/developer/applications. - Click on your application.
- Select the Marketplace Listing tab.
Pricing Configuration
Sessions are priced in SMART tokens. Users purchase SMART tokens from General Wisdom and spend them to launch sessions in your application.
Setting Your Price
| Field | Description | Example |
|---|---|---|
| Base Price | Tokens charged per session launch | 50 SMART |
| Session Duration | How long a single session lasts | 60 minutes |
| Extension Price | Tokens charged to extend an active session | 25 SMART |
| Extension Duration | Additional time added per extension | 30 minutes |
| Max Extensions | Maximum number of times a session can be extended | 3 |
Base Price: 50 SMART
Session Duration: 60 minutes
Extension Price: 25 SMART
Extension Duration: 30 minutes
Max Extensions: 3
A user who fully extends this example session pays 50 + (25 x 3) = 125 SMART tokens for 60 + (30 x 3) = 150 minutes total.
Pricing Tiers (Optional)
You can offer multiple pricing tiers for different access levels:
| Tier | Price | Duration | Description |
|---|---|---|---|
| Basic | 25 SMART | 30 min | Read-only access to data |
| Standard | 50 SMART | 60 min | Full search and export |
| Premium | 100 SMART | 120 min | Full access + API queries + bulk export |
To configure tiers:
- In the pricing section, click Add Pricing Tier.
- Name the tier and set its price, duration, and description.
- Define what features/permissions each tier unlocks.
Your application receives the tier information in the session JWT tier claim, allowing you to gate features accordingly.
Pricing Guidelines
- Review comparable applications in the marketplace for pricing context.
- Consider offering a low-cost introductory tier so users can evaluate your app before committing to a full session.
- Pricing changes on live listings require a 24-hour notice period before taking effect. Users who purchased before the change are not affected.
Listing Content
Description
Write a compelling description that tells users what they can accomplish with your application:
## What You Can Do
- Track vessel movements in real-time across global AIS networks
- Analyze historical routes with up to 12 months of data
- Set up geofence alerts for areas of interest
- Export investigation timelines as PDF reports
## Data Sources
- Global AIS terrestrial network (180,000+ stations)
- Satellite AIS (S-AIS) for deep ocean coverage
- Port authority databases (120+ countries)
## Use Cases
- **Maritime due diligence** — Verify vessel activity claims
- **Sanctions screening** — Detect dark shipping patterns
- **Insurance investigation** — Reconstruct incident timelines
Descriptions support Markdown formatting. Keep the primary description under 500 words. Use bullet points and headers for scannability.
Screenshots
Add screenshots showing your application in action:
- Click Add Screenshot in the listing editor.
- Upload images (recommended: 1280x720px PNG or JPEG).
- Add a caption for each screenshot.
- Drag to reorder.
Requirements:
- Minimum 3 screenshots, maximum 10
- First screenshot is used as the preview image in search results
- Captions are displayed below each image in the listing gallery
- Do not include any real PII or sensitive data in screenshots
Demo Video (Optional)
You can link a demo video that plays inline on your listing page:
Video URL: https://www.youtube.com/watch?v=xxxxx
Supported: YouTube, Vimeo, or a direct MP4 URL (max 100MB, max 3 minutes).
Categories and Discovery
Primary Category
Choose the single best-fit category (set during application registration).
Marketplace Tags
Add tags to improve discoverability in search:
Tags: vessel-tracking, ais, maritime, shipping, sanctions, due-diligence
Featured Collections
General Wisdom curates featured collections (e.g., "New This Month", "Corporate Due Diligence Toolkit"). Your listing may be selected for collections based on quality, user ratings, and relevance.
Listing Preview
Before submitting, use the Preview button to see your listing as users will see it:
- Marketplace card view (how it appears in search results)
- Full listing page (what users see when they click through)
- Mobile layout
Review each view and ensure your content renders correctly.
Submitting for Review
When your listing is ready:
- Click Submit for Review at the bottom of the listing editor.
- Your application moves to In Review state.
- The General Wisdom team reviews within 2-3 business days.
- You receive an email with the outcome:
- Approved — Your listing goes live immediately.
- Changes Requested — Feedback provided. Fix issues and resubmit.
Review Criteria
The review team checks for:
- Accurate description that matches actual application functionality
- Working Callback URL and session flow
- Appropriate pricing for the tier of service offered
- Screenshots that show real application functionality (no mockups)
- Compliance with the Provider Agreement
- No prohibited content (malware, illegal services, misleading claims)
Updating a Live Listing
After approval, you can still edit your listing:
| Change Type | Effect |
|---|---|
| Description, screenshots, tags | Immediate |
| Pricing | 24-hour notice period |
| Application URL or Callback URL | Requires re-review |
| Category change | Requires re-review |
Next Steps
- Accept the Provider Agreement
- Set up Stripe Connect to receive payouts
- Review the Go-Live Checklist