Skip to main content

​
Platform Apps API

Platform app routes expose cross-tenant operational data for platform operators. They require a platform key and route scopes when scoped platform keys are enabled.

​
Get Gas Spend

Returns sponsored gas reservations and settled spend for tenant-scoped wallets. Timestamp filters accept Unix seconds or milliseconds, and the server caps the range at 30 days. 
GET /platform/apps/gas_spend
Auth: Platform key with platform:gas-spend:read Query Parameters: 
{
  tenant_id: string;
  wallet_ids?: string;          // Comma-separated canonical Steward wallet IDs
  wallet_external_ids?: string; // Comma-separated tenant-local wallet external IDs
  start_timestamp?: number;
  end_timestamp?: number;
}
wallet_external_ids can also be sent as walletExternalIds. Steward resolves external IDs to canonical tenant wallet IDs before querying spend history, so response entries still use canonical agentId values. 
const spend = await steward.platformApps.getGasSpend({
  tenantId: "app-prod",
  walletIds: ["agent-1"],
  walletExternalIds: ["external-wallet-1"],
  startTimestamp: 1764195200,
  endTimestamp: 1764281600,
});
Response: 
{
  "ok": true,
  "data": {
    "tenantId": "app-prod",
    "walletIds": ["agent-1"],
    "count": 1,
    "reservedUsd": "1.250000",
    "actualUsd": "1.000000",
    "entries": [
      {
        "id": "evt_123",
        "tenantId": "app-prod",
        "agentId": "agent-1",
        "provider": "mock",
        "mode": "erc4337",
        "status": "settled",
        "reservedUsd": "1.250000",
        "actualUsd": "1.000000"
      }
    ]
  }
}

​
External ID Errors

StatusError
400wallet_external_ids contains an invalid ID or more than 100 IDs.
404One or more wallet external IDs are unknown in the tenant.
409A wallet external ID maps to multiple tenant wallets and must be deduplicated before querying.