Funding And Destinations
This group covers reusable funding surfaces and reusable destination surfaces. Read it as setup before execution: provision inbound surfaces first, read the actual deposit coordinates second, then define reusable outbound and rail configuration surfaces.
Reusable Setup Surfaces
List funding endpoints
Provisioned inbound surfaces. Read funding endpoints to inspect which reusable inbound routes already exist for a tenant or account scope.
Request URL
GET https://business-api.youhodler.com/funding-endpoints?account_ref=client-accounts/aaa111&rail_class=crypto&page_size=20Response
{
"items": [
{
"account_ref": "client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"asset": "USDC",
"created_at": "2026-05-01T10:00:00Z",
"crypto_routing": {
"asset": "USDC",
"endpoint": {
"address": "0xAbCd1234567890AbCd1234567890AbCd12345678",
"memo": null
},
"network": "ethereum"
},
"fiat_rail": null,
"fiat_routing": null,
"id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"network": "ethereum",
"rail_class": "crypto",
"status": "active",
"updated_at": "2026-05-01T10:00:00Z"
}
],
"next_page_token": null
}List deposit instructions
Readable deposit coordinates. Read deposit instructions after endpoint provisioning when an operator or external system needs the actual inbound coordinates.
Request URL
GET https://business-api.youhodler.com/deposit-instructions?account_ref=client-accounts/aaa111&rail_class=cryptoResponse
{
"items": [
{
"account_ref": "client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"asset": "USDC",
"created_at": "2026-05-01T10:00:00Z",
"crypto_routing": {
"asset": "USDC",
"endpoint": {
"address": "0xAbCd1234567890AbCd1234567890AbCd12345678",
"memo": null
},
"network": "ethereum"
},
"expires_at": null,
"fiat_routing": null,
"funding_endpoint_id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"rail_class": "crypto",
"updated_at": "2026-05-01T10:00:00Z"
}
],
"next_page_token": null
}Create withdrawal destination
Reusable outbound target. Create a withdrawal destination when later settlement or operational cash-out should point at a named, reusable destination resource.
Request URL
POST https://business-api.youhodler.com/withdrawal-destinationsRequest Body
{
"crypto_routing": {
"asset": "USDC",
"destination": {
"address": "0xAbCd1234567890AbCd1234567890AbCd12345678",
"memo": null
},
"label": "My ETH wallet",
"network": "ethereum"
},
"rail_class": "crypto",
"scope_ref": "clients/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
}Response
{
"asset": "USDC",
"created_at": "2026-05-01T10:00:00Z",
"crypto_routing": {
"asset": "USDC",
"destination": {
"address": "0xAbCd1234567890AbCd1234567890AbCd12345678",
"memo": null
},
"label": "My ETH wallet",
"network": "ethereum"
},
"fiat_routing": null,
"id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"label": "My ETH wallet",
"rail_class": "crypto",
"scope_ref": "clients/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
"status": "active",
"updated_at": "2026-05-01T10:00:00Z"
}