WalletKit API DESIGN PARTNER PREVIEW

Create a new provider connection with scoped credentials.

curl -X POST https://api.alloy.build/v1/provider-connections \
  -H "Authorization: Bearer alloy_sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: conn_setup_001" \
  -d '{
    "provider": "fireblocks",
    "name": "Production Fireblocks",
    "credentials": {
      "api_key": "fb-api-...",
      "api_secret": "-----BEGIN RSA PRIVATE KEY-----\n...",
      "workspace_id": "ws_..."
    },
    "environment": "production"
  }'

conn = requests.post(f"{BASE}/provider-connections",
    headers=headers,
    json={
        "provider": "fireblocks",
        "name": "Production Fireblocks",
        "credentials": {
            "api_key": "fb-api-...",
            "api_secret": "-----BEGIN RSA PRIVATE KEY-----\n...",
            "workspace_id": "ws_..."
        },
        "environment": "production"
    }
)
print(conn.json())

const conn = await fetch(`${BASE}/provider-connections`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    provider: "fireblocks",
    name: "Production Fireblocks",
    credentials: {
      api_key: "fb-api-...",
      api_secret: "-----BEGIN RSA PRIVATE KEY-----\n...",
      workspace_id: "ws_..."
    },
    environment: "production"
  })
});
console.log(await conn.json());

{
  "id": "pconn_3kF8xQ2...",
  "provider": "fireblocks",
  "name": "Production Fireblocks",
  "environment": "production",
  "status": "active",
  "capabilities": {
    "assets": ["BTC", "ETH", "USDC", "USDT", "SOL"],
    "networks": ["ethereum", "bitcoin", "solana", "base", "polygon"],
    "signing_methods": ["mpc", "raw"]
  },
  "created_at": "2026-07-06T14:30:00Z"
}

List all provider connections for the current tenant. Credentials are redacted.

Retrieve a single provider connection with capability metadata and health status.

Deactivate a provider connection. Active transaction intents using this connection must be resolved first.

List canonical wallets across all connected providers, with filtering and pagination.

{
  "data": [
    {
      "id": "wal_9xK2mR...",
      "provider": "fireblocks",
      "provider_ref": { "vault_id": "12", "asset_id": "ETH" },
      "name": "Treasury ETH",
      "network": "ethereum",
      "asset": "ETH",
      "addresses": [
        { "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18", "type": "deposit" }
      ],
      "balances": {
        "available": "142.583200",
        "pending": "0.000000",
        "staked": "32.000000"
      },
      "connection_id": "pconn_3kF8xQ2...",
      "created_at": "2026-06-15T09:00:00Z",
      "synced_at": "2026-07-06T14:28:00Z"
    }
  ],
  "next_cursor": "wal_8bN3pQ...",
  "has_more": true
}

Retrieve a single wallet with full balance breakdown and provider reference.

List all addresses for a wallet, including deposit and change addresses.

Create a transaction intent. Policy and risk hooks evaluate before provider submission.

curl -X POST https://api.alloy.build/v1/transaction-intents \
  -H "Authorization: Bearer alloy_sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: payout_batch_4829" \
  -d '{
    "source_wallet_id": "wal_9xK2mR...",
    "destination": {
      "type": "address",
      "address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
      "network": "base"
    },
    "asset": "USDC",
    "amount": "25000.00",
    "external_ref": "payout_batch_4829",
    "note": "Q3 vendor payment — Acme Corp"
  }'

intent = requests.post(f"{BASE}/transaction-intents",
    headers=headers,
    json={
        "source_wallet_id": "wal_9xK2mR...",
        "destination": {
            "type": "address",
            "address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
            "network": "base"
        },
        "asset": "USDC",
        "amount": "25000.00",
        "external_ref": "payout_batch_4829",
        "note": "Q3 vendor payment — Acme Corp"
    }
)
print(intent.json())

const intent = await fetch(`${BASE}/transaction-intents`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    source_wallet_id: "wal_9xK2mR...",
    destination: {
      type: "address",
      address: "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
      network: "base"
    },
    asset: "USDC",
    amount: "25000.00",
    external_ref: "payout_batch_4829",
    note: "Q3 vendor payment — Acme Corp"
  })
});
console.log(await intent.json());

{
  "id": "txn_intent_7qW4nP...",
  "status": "controls_pending",
  "source_wallet_id": "wal_9xK2mR...",
  "destination": {
    "type": "address",
    "address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
    "network": "base"
  },
  "asset": "USDC",
  "amount": "25000.00",
  "external_ref": "payout_batch_4829",
  "controls": {
    "policy": { "status": "evaluating" },
    "risk": { "status": "evaluating" }
  },
  "provider_ref": null,
  "created_at": "2026-07-06T14:35:00Z",
  "updated_at": "2026-07-06T14:35:00Z"
}

List transaction intents with filters for status, wallet, asset, date range, and external_ref.

Retrieve full intent with controls state, provider reference, timeline, and raw provider evidence.

Cancel a pending intent. Only possible before provider submission.

Attach a policy or risk decision to a transaction intent.

{
  "id": "pdec_2mX9rT...",
  "transaction_intent_id": "txn_intent_7qW4nP...",
  "type": "limit_check",
  "result": "approved",
  "evidence": {
    "daily_limit": "100000.00",
    "daily_used": "45000.00",
    "remaining": "55000.00"
  },
  "decided_by": "policy_engine_v2",
  "created_at": "2026-07-06T14:35:01Z"
}

List all policy decisions for a transaction intent, in evaluation order.

List events with filters for type, resource, provider, and time range.

{
  "data": [
    {
      "id": "evt_4nR8wQ...",
      "type": "transaction.controls_passed",
      "resource_id": "txn_intent_7qW4nP...",
      "provider": "fireblocks",
      "canonical_state": "controls_passed",
      "raw_provider_event": { "type": "TRANSACTION_APPROVED", "... ": "..." },
      "correlation_id": "corr_9xK2mR...",
      "created_at": "2026-07-06T14:35:02Z"
    }
  ],
  "next_cursor": "evt_3mQ7vP...",
  "has_more": true
}

Replay events from a specific point. Returns events in chronological order with raw provider evidence for debugging missed or duplicate webhooks.

Create a reconciliation export for a date range with format and filter options.

{
  "id": "rexp_6pT3wN...",
  "status": "processing",
  "period": { "start": "2026-07-01T00:00:00Z", "end": "2026-07-06T23:59:59Z" },
  "format": "csv",
  "download_url": null,
  "estimated_ready_at": "2026-07-06T14:40:00Z",
  "created_at": "2026-07-06T14:36:00Z"
}

Poll GET /v1/reconciliation-exports/{id} until status is ready and download_url is populated. URLs expire after 1 hour.

Register a webhook endpoint.