Instructions

instruction = await client.instructions.submit({
    "template_slug": "dvp-bilateral",
    "role": "seller",
    "party": {
        "external_reference": "KSFI-II-4401",
        "name": "Securitize Fund I",
        "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
        "chain_id": 11155111,
    },
    "legs": [{
        "instrument_id": "US09311A1007",
        "quantity": "12000000",
        "direction": "deliver",
    }],
    "timeout_at": "2026-12-01T00:00:00Z",
    "idempotency_key": client.generate_idempotency_key(),
})

print(instruction.trade_reference)  # "KS-abc12345"
print(instruction.status)           # "pending_match" or "matched"
print(instruction.settlement_id)    # UUID if matched, None if pending

instruction = await client.instructions.get("instruction-uuid")

result = await client.instructions.list(status="pending_match", limit=20)
for instr in result.items:
    print(f"{instr.trade_reference}: {instr.status}")

cancelled = await client.instructions.cancel("instruction-uuid")