Token & Market Metadata

Creates the initial metadata for a newly deployed token or prediction market. This must be called after the on-chain transaction is confirmed. The server reads the token name, symbol, creator, and options directly from the blockchain. You only supply the off-chain fields (description, socials, image).

Request Body (JSON)

{
  "address": "0x...",           // Contract address (required)
  "description": "string",     // Optional
  "website": "string",         // Optional
  "telegram": "string",        // Optional
  "twitterx": "string",        // Optional
  "image": "string"            // IPFS URL from /api/images (optional)
}

The server automatically detects whether the address is a regular token, public prediction market, or private prediction market by reading getMarketData on the two market hosts.

Response

{ "url": "https://...pinata.cloud/ipfs/...", "cid": "bafy..." }

Server-Side Verification

The server reads the following directly from the blockchain:

• name and symbol: from the token contract
• dev: from DEV() for a token; for a market, from getMarketData(address).creator (on a market token DEV() is the host)
• multiplier: from hybridMultiplier()
• isPrediction and predictionType: auto-detected by checking public and private prediction contracts
• options: from TrancheReader.getAllOutcomes(host, marketToken) (prediction markets only)
• eventType: from getMarketData(address).isPrivate (who may bet; always false on the public host; prediction markets only). predictionType says which host the market lives on.

// Create metadata for a newly deployed token or prediction market
// The server auto-detects whether it's a token, public market, or private market
async function createMetadata(contractAddress, imageUrl, sessionCookie) {
  const res = await fetch("https://launchonbasis.com/api/metadata", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Cookie": sessionCookie,
    },
    body: JSON.stringify({
      address: contractAddress,
      description: "My awesome project",
      website: "https://example.com",
      telegram: "https://t.me/myproject",
      twitterx: "https://x.com/myproject",
      image: imageUrl,
    }),
  });

  const { url, cid } = await res.json();
  return { url, cid };
};