myriad-on-abstract

name: myriad-on-abstract description: Integrate Myriad Protocol prediction markets on Abstract — REST API for market data, polkamarkets-js SDK for trading outcome shares, builder revenue sharing via referralBuy, and contract addresses. This skill should be used when working with Myriad API, prediction markets on Abstract, polkamarkets-js SDK, trading or buying/selling prediction shares, builder codes, referralBuy, claiming winnings, Myriad contract addresses, or Myriad Protocol integration.

Myriad on Abstract

Myriad Protocol is a prediction market platform live on Abstract (and Linea, BNB Chain). Integrate it to show market data, let users trade outcome shares, and earn revenue from buy volume.

Architecture

Quick Start

API Setup

Base URL: https://api-v2.myriadprotocol.com/
Auth: x-api-key: <your_api_key>  (or ?api_key=<your_api_key>)
Rate limit: 50 req/s per IP/key

Contact the Myriad team to obtain an API key.

Common Flow: Fetch Markets → Get Quote → Execute Trade

// 1. Fetch open markets on Abstract
const res = await fetch(
  "https://api-v2.myriadprotocol.com/markets?network_id=2741&state=open&sort=volume_24h&limit=10",
  { headers: { "x-api-key": "<your_api_key>" } }
);
const { data: markets } = await res.json();

// 2. Get a buy quote for a specific outcome
const quote = await fetch("https://api-v2.myriadprotocol.com/markets/quote", {
  method: "POST",
  headers: { "Content-Type": "application/json", "x-api-key": "<your_api_key>" },
  body: JSON.stringify({
    market_id: 164,
    outcome_id: 0,
    network_id: 2741,
    action: "buy",
    value: 100,
    slippage: 0.01,
  }),
});
// Returns: shares, price_before, price_after, calldata, fees

// 3. Execute via SDK (see references/sdk.md) or send calldata directly

Common Flow: Claim Winnings

const claim = await fetch("https://api-v2.myriadprotocol.com/markets/claim", {
  method: "POST",
  headers: { "Content-Type": "application/json", "x-api-key": "<your_api_key>" },
  body: JSON.stringify({ market_id: 164, network_id: 2741 }),
});
// Returns: action ("claim_winnings" | "claim_voided"), outcome_id, calldata

Decision: API vs SDK

Abstract Contract Addresses

Revenue Sharing

Builders earn the distributor_fee (typically 1%) on eligible buy trades by using referralBuy with a whitelisted builder code. Must apply for whitelisting with the Myriad team.

See references/revenue-sharing.md for full integration details.

Gotchas

• ERC-20 approval required before trading — call erc20.approve() for the PredictionMarket contract before any buy/sell
• Buy quotes take value only — the amount of the collateral token to spend (not shares)
• Sell quotes accept value or shares — provide exactly one, not both
• referralBuy works on any market — calling it without a whitelisted code is safe, it just won't earn revenue
• network_id is required on most API calls — use 2741 for Abstract mainnet, 11124 for testnet
• Token decimals vary — USDC.e on Abstract uses 6 decimals; always check decimals() before formatting amounts

Feature Reference