HoodShare Developer Docs

Overview

HoodShare is a fast text, code, and media sharing tool with built-in QR codes and URL shortening, plus an optional token gate for Hood Chain - Robinhood's AI-native Layer 2 built on Arbitrum tech.

Every share gets a random, unguessable short ID and is stored with a TTL you choose (1 day up to 90 days). There's no wallet or blockchain step required to create a basic share - the token gate is an optional layer for higher rate limits and extended expiration.

Key capabilities

Quick Start

Create your first share in under a minute. The web app requires signing in with email or a wallet; calling the API directly does not.

Core Concepts

Share IDs

Every share gets a random 12-character ID (e.g. 7nE7yfQx3kLm) generated server-side - not derived from your content or wallet, so it can't be guessed or enumerated.

Storage & expiration

Shares are stored in Redis (Upstash) as JSON with a TTL matching the expiration you pick at creation time - 1 day up to 90 days. Once the TTL elapses, Redis evicts the key and the share is gone; there is no separate delete step and no permanent archive.

{
  id: string;
  format: "text" | "markdown" | "code" | "media";
  content: string | null;
  fileUrl?: string | null;   // media shares only
  creatorAddress: string | null; // RobinHood Chain wallet, optional
  createdAt: number;  // ms epoch
  expiresAt: number;  // ms epoch
}

Media uploads

Images, video, audio, and PDFs are uploaded via UploadThing rather than stored inline in Redis. The share record keeps a reference to the file URL and expires the same way as text shares.

API Reference

HoodShare exposes a JSON REST API for creating shares, retrieving content, and shortening URLs. All endpoints accept and return application/json.

Create Share

Creates a new content share and returns a short ID. The content is stored and assigned a unique URL.

curl -X POST https://hoodshare.xyz/api/share \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello, permanent web.",
    "format": "text",
    "expiresIn": 604800
  }'

{
  "id": "7nE7yf"
}

The share is accessible at https://hoodshare.xyz/s/7nE7yf.

Retrieve Content

Returns the stored share object by ID. Returns 404 if the share has expired or does not exist.

curl https://hoodshare.xyz/api/get/7nE7yf

{
  "content": "Hello, permanent web.",
  "format": "text",
  "createdAt": 1705312200000,
  "expiresAt": 1705917000000,
  "creatorAddress": null
}

Shorten URL

Creates a short redirect URL for any valid HTTP/HTTPS link.

{
  "id": "abc123",
  "originalUrl": "https://example.com/very/long/path",
  "shortUrl": "https://hoodshare.xyz/l/abc123",
  "createdAt": 1705312200000,
  "clicks": 0
}

Verify Access

Checks a wallet's $HSHARE balance and returns its access tier. Use this to authenticate a script or client and determine its rate limit before calling the other endpoints.

{
  "success": true,
  "tier": "pro",
  "balance": 750000,
  "rateLimit": 1000,
  "features": {
    "shareExpiration": 180,
    "qrSize": 1200,
    "urlShortener": true,
    "analytics": true,
    "prioritySupport": false
  },
  "message": "Agent verified: pro tier"
}

API Access

There's no client library or SDK to install. Anything that can make an HTTP request - a script, a cron job, a backend service - can call the API directly.

Config reference

{
  "name": "hoodshare",
  "description": "Instant text, code, and media sharing on RobinHood Chain",
  "endpoint": "https://hoodshare.xyz/api",
  "capabilities": ["share", "retrieve", "shorten"],
  "auth": {
    "type": "wallet",
    "verify": "/api/agent/verify"
  }
}

Rate Limits

API rate limits are determined by the caller's $HSHARE token balance. Verify a wallet to check its current tier.

Tools

Share Content

The primary tool. Paste text, Markdown, or code into the editor at /app. Choose a format, set expiration, and create a permanent share. The share URL and QR code are generated immediately.

Supported formats: Plain Text, Markdown (with live preview), Code (preserves indentation).

QR Code Generator

Generate QR codes for any URL at /qr-generator. Useful for bridging physical and digital content - print a QR that points to a permanent HoodShare share.

URL Shortener

Shorten any URL at /url-shortener. Returns a clean hoodshare.xyz/l/... redirect with click tracking. Also available via the POST /api/shorten endpoint.

Access Control

Token Gate

HoodShare can require a minimum $HSHARE token balance to access premium features. When enabled, the app checks the connected wallet's token balance against configured thresholds.

In development mode, the token gate is disabled and all features are available. In production, access is determined by wallet balance with three tiers: Free, Pro, and Premium.

Wallet Integration

HoodShare connects to any injected EVM wallet (MetaMask, Rabby, and others) via eth_requestAccounts. Connect your wallet from the app to unlock gated features tied to your $HSHARE balance on RobinHood Chain.

FAQ