API Usage

The CRYMBO Oracle API provides programmatic access to identity exchange, compliance validation, and transaction monitoring. This page covers the core endpoints and usage patterns.

Base URLs

Environment	Base URL
Production	https://api.crymbo.link/v1/
Sandbox	https://sandbox-api.crymbo.link/v1/

Authentication

All requests require an API key:

Authorization: Bearer YOUR_API_KEY

Core Endpoints

Validate Transaction

POST /oracle/validate

Validates a transaction against applicable compliance rules before execution.

{
  "senderWallet": "0xSENDER",
  "receiverWallet": "0xRECEIVER",
  "amount": "5000.00",
  "asset": "USDC",
  "chain": "ethereum",
  "transactionType": "transfer"
}

Response:

{
  "status": "COMPLIANT",
  "attestationId": "att_abc123",
  "rules": ["FATF_TRAVEL_RULE", "KYC_THRESHOLD"],
  "timestamp": "2026-02-11T10:00:00Z"
}

Request Identity

POST /oracle/identity/request

Initiates an identity exchange request to a counterparty.

Get Compliance Status

GET /oracle/compliance/{transactionId}

Returns the current compliance status of a specific transaction.

List Attestations

GET /oracle/attestations?wallet=0x...&from=2026-01-01&to=2026-02-11

Lists all attestations involving a specific wallet within a date range.

Rate Limits

Tier	Rate Limit
Sandbox	100 requests/minute
Production (Standard)	500 requests/minute
Production (Enterprise)	Custom — contact CRYMBO

Error Codes

Code	Meaning
400	Invalid request parameters
401	Authentication failure
403	Insufficient permissions
404	Resource not found
429	Rate limit exceeded
500	Internal Oracle error

SDKs

• JavaScript/TypeScript: npm install @crymbo/oracle-sdk
• Python: pip install crymbo-oracle

Full API reference: crymbo.redoc.ly