Operations
This group covers real financial execution. Read it from preview into action: start with fee or price estimation, then move into mutating execution requests across withdrawal, conversion, and ramp families.
Preview And Execute
Create fee preview
Pre-execution fee check. Create a fee preview when the integration needs visible costs before submitting a real operation.
Request URL
POST https://business-api.youhodler.com/fee-previewsRequest Body
{
"operation_type": "withdrawal_crypto",
"principal_amount": {
"amount": "100.00",
"currency": "USDC"
},
"requested_at": "2026-05-01T10:00:00Z",
"service_type": "withdrawal_crypto",
"settlement_amount": null,
"subject_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
}Response
{
"fee_preview": {
"binding": "non_binding",
"computed_at": "2026-05-01T10:00:00Z",
"enterprise_ca_version": 2,
"fee_summary": {
"components": [
{
"type": "network_fee",
"amount": {
"amount": "1.00",
"currency": "USDC"
},
"payee_ref": null
}
],
"total": {
"amount": "1.00",
"currency": "USDC"
}
},
"operation_type": "withdrawal_crypto",
"platform_ca_version": 1
}
}Get indicative conversion price
Quoted conversion direction. Read the indicative price surface when the caller needs a directional conversion estimate before creating the real conversion request.
Request URL
GET https://business-api.youhodler.com/prices/indicative?from_asset=USDC&to_asset=BTC&amount_basis=from&from_amount=250.00&account_ref=client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7bResponse
{
"amount_basis": "from",
"binding": false,
"calculated_at": "2026-05-01T10:00:00Z",
"expires_at": "2026-05-01T10:00:00Z",
"flow_type": "conversion",
"from_amount": {
"currency": "USDC",
"value": "250.00"
},
"from_asset": "USDC",
"indicative_price": {
"computed_at": "2026-05-01T10:00:00Z",
"price": "65789.47",
"price_type": "indicative"
},
"pricing_mode": "indicative",
"to_amount": {
"currency": "BTC",
"value": "0.00380000"
},
"to_asset": "BTC"
}Create withdrawal
Outbound account-scoped execution. Create a withdrawal when value should leave the operating account boundary through an explicit rail and destination.
Request URL
POST https://business-api.youhodler.com/withdrawalsRequest Body
{
"account_ref": "client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"amount": {
"currency": "EUR",
"value": "100.00"
},
"rail": "fiat",
"withdrawal_destination_id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
}Response
{
"account_ref": "client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"approval_ref": null,
"created_at": "2026-05-01T10:00:00Z",
"failure_reason": null,
"family": "withdrawal",
"family_params": {},
"fee_summary": {
"components": [
{
"amount": {
"currency": "USDC",
"value": "1.00"
},
"kind": "network_fee"
}
],
"total": {
"currency": "USDC",
"value": "1.00"
}
},
"fill_rate": null,
"id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"principal_amount": {
"currency": "USDC",
"value": "250.00"
},
"settled_at": null,
"status": "executing",
"subject_attribution": {
"actor": null,
"approved_by": null,
"authenticated_principal": {
"id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"kind": "user",
"tenant_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
},
"enterprise_binding": {
"tenant_type": "enterprise",
"topology_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
},
"federation": null,
"identity_source": "platform-managed",
"initiated_by": null,
"subject": {
"id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"kind": "user",
"tenant_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
}
},
"updated_at": "2026-05-01T10:00:00Z"
}Create conversion
In-account asset change. Create a conversion when the operating account needs to change one asset into another through the canonical conversion family.
Request URL
POST https://business-api.youhodler.com/conversionsRequest Body
{
"account_ref": "client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"from_amount": {
"currency": "USDC",
"value": "250.00"
},
"to_currency": "BTC"
}Response
{
"account_ref": "client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"approval_ref": null,
"created_at": "2026-05-01T10:00:00Z",
"failure_reason": null,
"family": "withdrawal",
"family_params": {},
"fee_summary": {
"components": [
{
"amount": {
"currency": "USDC",
"value": "1.00"
},
"kind": "network_fee"
}
],
"total": {
"currency": "USDC",
"value": "1.00"
}
},
"fill_rate": null,
"id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"principal_amount": {
"currency": "USDC",
"value": "250.00"
},
"settled_at": null,
"status": "executing",
"subject_attribution": {
"actor": null,
"approved_by": null,
"authenticated_principal": {
"id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"kind": "user",
"tenant_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
},
"enterprise_binding": {
"tenant_type": "enterprise",
"topology_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
},
"federation": null,
"identity_source": "platform-managed",
"initiated_by": null,
"subject": {
"id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"kind": "user",
"tenant_ref": "enterprises/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
}
},
"updated_at": "2026-05-01T10:00:00Z"
}Create on-ramp session
Inbound purchase surface. Create an on-ramp session when a caller needs a guided fiat-to-asset acquisition flow tied back to an account boundary.
Request URL
POST https://business-api.youhodler.com/on-ramp-sessionsRequest Body
{
"account_ref": "client-accounts/aaa111",
"fiat_currency": "EUR",
"asset": "BTC"
}Response
{
"id": "ors_123",
"resource": "on-ramp-session",
"status": "requested"
}Create off-ramp session
Outbound liquidation surface. Create an off-ramp session when an asset position needs a guided asset-to-fiat exit path.
Request URL
POST https://business-api.youhodler.com/off-ramp-sessionsRequest Body
{
"account_ref": "client-accounts/aaa111",
"asset": "BTC",
"fiat_currency": "EUR"
}Response
{
"id": "ofs_123",
"resource": "off-ramp-session",
"status": "requested"
}