SIMA

Example

Trading Bot Example

Trading bots use SIMA through direct APIs — offer → purchase → payment-intent → confirm-payment — not browser extensions.

Examples HubFor AI AgentsPrompt LibraryOpenAPI

Example Scenario

When this pattern applies.

A Solana trading bot authenticates its wallet, requests an asset-denominated offer, purchases protection, pays SOL, and reads the ACTIVE certificate.

Request

Example request shape.

POST /agent/protection/offer
Authorization: Bearer BOT_ACCESS_TOKEN
Content-Type: application/json

{
  "chain": "SOLANA",
  "walletAddress": "BOT_WALLET_ADDRESS",
  "assetAddress": "TOKEN_ADDRESS",
  "assetSymbol": "TOKEN",
  "assetType": "TOKEN",
  "protectedAmount": "2500"
}

Response

Example response shape.

{
  "protectedAmount": "2500",
  "premiumAmount": "125",
  "coverageAmount": "1250",
  "deductibleAmount": "250",
  "maximumNetPayment": "1000",
  "rulesVersion": "SIMA_V1_50_5_10_40",
  "purchaseEndpoint": "POST /agent/protection/purchase"
}

TypeScript

Copy-paste friendly example.

async function tradingBotOffer(accessToken: string, tokenAddress: string) {
  const offer = await fetch("https://api.sima-prime.com/agent/protection/offer", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      chain: "SOLANA",
      walletAddress: "BOT_WALLET_ADDRESS",
      assetAddress: tokenAddress,
      assetSymbol: "TOKEN",
      assetType: "TOKEN",
      protectedAmount: "2500",
    }),
  });
  if (!offer.ok) throw new Error("Trading bot offer failed");
  return offer.json();
}

Architecture Flow

  • Bot authenticates wallet through SIMA wallet auth.
  • Bot requests POST /agent/protection/offer.
  • Bot purchases with PURCHASE_PROTECTION.
  • Bot pays SOL using payment-intent, then confirm-payment.
  • Bot reads ACTIVE certificate via OpenAPI.

Safety Boundary

  • No private keys or seed phrases are sent to SIMA.
  • Examples do not execute payments or blockchain transfers.
  • Quotes do not issue certificates.
  • Evidence does not approve claims or authorize payout.
  • FULL_PAYMENT still requires treasury review before execution.