Documentation Index
Fetch the complete documentation index at: https://docs.yieldo.xyz/llms.txt
Use this file to discover all available pages before exploring further.
All API errors return a JSON body with a detail field:
{
"detail": "Human-readable error message"
}
| Status | Meaning |
|---|
| 400 | Bad request / invalid input |
| 404 | Resource not found |
| 422 | Validation error |
| 500 | Internal server error |
Common Errors
Vault Not Found (404)
{ "detail": "Vault some-vault-id not found" }
GET /v1/vaults to get valid vault IDs.
No Route Found (400)
{ "detail": "No route found for this token/chain combination" }
- Token not supported on the source chain
- Amount too small to bridge
- Liquidity unavailable for this pair
Fix: Try a different source token, increase the amount, or try a different source chain.
Zero Output Amount (400)
{ "detail": "LiFi returned zero output amount" }
Contract Calls Quote Unavailable (400)
{ "detail": "LiFi contract calls quote unavailable for this route. Use fallback flow." }
No Deposit Router (400)
{ "detail": "No deposit router on chain {chain_id}" }
Validation Error (422)
{
"detail": [
{
"loc": ["body", "from_amount"],
"msg": "field required",
"type": "value_error.missing"
}
]
}
Best Practices
- Always check for
approval - It can be null for native token deposits
- Handle quote expiry - Quotes can become stale. If the build fails, fetch a new quote
- Poll with backoff - For status checks, start at 15s intervals. Don’t poll faster than every 10 seconds
- Show the LiFi explorer link - Give users
tracking.lifi_explorer so they can independently track their bridge transfer
