SIMA

Example

Certificate Read Example

Read a SIMA certificate record after purchase. This confirms the certificate exists for the authenticated wallet workflow.

Examples HubFor AI AgentsPrompt LibraryOpenAPI

Example Scenario

When this pattern applies.

An AI assistant or trading bot needs to read whether a SIMA certificate record is ACTIVE before preparing a separate claim investigation workflow.

Request

Example request shape.

GET /agent/protection/certificates/{id}
Authorization: Bearer ACCESS_TOKEN

Response

Example response shape.

{
  "id": "CERTIFICATE_ID",
  "certificateStatus": "ACTIVE",
  "assetSymbol": "TOKEN_OR_MINT",
  "premiumAmountSol": "0.05"
}

TypeScript

Copy-paste friendly example.

async function readCertificate(accessToken: string, certificateId: string) {
  const response = await fetch(
    `https://api.sima-prime.com/agent/protection/certificates/${certificateId}`,
    {
      method: "GET",
      headers: {
        Authorization: `Bearer ${accessToken}`,
      },
    },
  );

  if (!response.ok) throw new Error("Certificate read failed");
  return response.json();
}

Architecture Flow

  • Authenticate wallet or agent.
  • Purchase protection and confirm premium payment.
  • GET the certificate by id.
  • Use certificate status as claim/investigation context only.
  • Do not treat certificate presence as claim or payout approval.

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.