API reference · preview
PREVIEWOne endpoint. The route.
The intended interface, published early for review. The endpoint is not open to integrators yet — keys go to early-access partners first.
Base URL & authentication
Base URL: https://loaditglobal.com. Authenticate with a partner API key in the x-api-key header. Keys are issued to early-access partners.
POST /api/v1/route
Returns the selected, supported settlement route for a stated origin (funding method), destination (asset), and amount.
Request · preview
POST /api/v1/route
x-api-key: $LOADIT_API_KEY
Content-Type: application/json
{ "amount_usd": 1000, "payment_method": "Bank Transfer", "asset": "USDC", "preferred": "auto" }Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| amount_usd | number | yes | Amount to move, in USD. Must be positive. |
| asset | string | no | Destination asset: BTC, ETH, SOL, XRP, USDC, USDT. Default USDC. |
| payment_method | string | no | Origin: Cash, Debit Card, Credit Card, Bank Transfer. Default Debit Card. |
| preferred | string | no | auto (HQ decides) or force a network: solana, base, ethereum, polygon, xrpl, lightning. |
| destination | string | no | Optional wallet address; sharpens the risk score. |
Response
200 OK · preview
{
"ok": true,
"route": {
"id": "rt_…",
"network": "solana",
"network_name": "Solana",
"asset": "USDC",
"amount_usd": 1000,
"payment_method": "Bank Transfer",
"loadit_fee_usd": 7.5,
"swap_fee_usd": 0,
"total_usd": 1007.5,
"eta": "~4s",
"eta_seconds": 4,
"confidence": 0.94,
"risk": "low",
"settlement": "non_custodial",
"path": ["Bank Transfer", "HQ", "Solana", "USDC"],
"explanation": "…"
},
"meta": {
"engine": "HQ", "version": "v1",
"fees_live": true,
"disclaimer": "Estimates dependent on live market and network conditions."
}
}| Field | Meaning |
|---|---|
| route.network | Selected rail identifier; network_name is the display name. |
| route.loadit_fee_usd | Loadit's convenience fee (0.75%, $1 minimum). |
| route.swap_fee_usd | Loadit's visible swap fee (0.25%) when the destination differs from the received asset. |
| route.total_usd | All-in estimate for the amount plus Loadit fees. |
| route.eta / eta_seconds | Expected end-to-end settlement time. |
| route.confidence | HQ's confidence in this selection, 0–1. |
| route.path | Ordered legs from origin to destination. |
| route.settlement | Always non_custodial — delivery to a destination the customer controls. |
Errors
| Status | error | When |
|---|---|---|
| 401 | missing_api_key / invalid_api_key | No key, or a key that is not provisioned. |
| 422 | invalid_amount | amount_usd missing, non-numeric, or ≤ 0. |
| 422 | invalid_asset / invalid_payment_method / invalid_preferred | Value not in the allowed list; the response includes allowed. |
| 429 | rate_limited | Per-key limit exceeded. |
Rate limits
Per-key limits are set with each early-access partner. Volume tiers follow by agreement.
Planned endpoints
PLANNEDShapes shown for design review.
Conceptual
POST /api/v1/transactions create a transaction — type: load | send | convert | receive | cash_out | connect | spend
one source, one or many outputs (Multi-Asset Load, allocations, recipient rules)
GET /api/v1/transactions/:id parent state: quoted → funded → converting → paying_out → settled; every leg inside
POST /api/v1/transactions/:id/heal re-score remaining legs under the same id after a partner or network failure
GET /api/v1/capabilities the capability registry: funding methods, assets, networks, partners live right now
GET /api/v1/routes list supported corridors and their status
POST /api/v1/receive-rules a standing rule for how incoming value arrives and is allocated (Receive)The full object, its legs, partial-failure rules, and idempotency are described in the transaction model preview.