Skip to main content
GET
/
api
/
quotes
/
preflight
Quote Preflight (Balance Check)
curl --request GET \
  --url https://api.teel.finance/api/quotes/preflight
{
  "ok": false,
  "required": "1500.000000",
  "requiredUnits": "1500000000",
  "available": "1200.500000",
  "availableUnits": "1200500000",
  "eoa": "0x1234abcd5678ef901234abcd5678ef901234abcd",
  "chainId": 137,
  "token": "USDC",
  "decimals": 6
}
A read-only check for payouts that start from stablecoin (stablecoin-to-fiat, stablecoin-to-stablecoin). Call it before executing to confirm the source wallet holds enough of the token on the right chain, so an insufficient balance surfaces up front instead of as a stranded payout. No state is changed.

​
Query Parameters

​
crypto_ticker
string
required
Platform crypto ticker including chain suffix, e.g. USDCPOLYGON, USDCBASE. Determines the chain the balance is read on.
​
required
number
required
The amount needed, in display units (e.g. 1500.123456).
​
wallet
string
required
EVM wallet address (hex) to check the balance of.

​
Response

​
ok
boolean
true when the wallet holds at least required. false is not an error — it means the wallet is short; use required vs available to render the gap.
​
required
string
Required amount, display units.
​
requiredUnits
string
Required amount, raw token units (string-encoded big integer).
​
available
string
Wallet balance, display units.
​
availableUnits
string
Wallet balance, raw token units.
​
eoa
string
The wallet address checked (echoed back).
​
chainId
integer
Chain the balance was read on.
​
token
string
Token symbol (e.g. USDC).
​
decimals
integer
Token decimals.
{
  "ok": false,
  "required": "1500.000000",
  "requiredUnits": "1500000000",
  "available": "1200.500000",
  "availableUnits": "1200500000",
  "eoa": "0x1234abcd5678ef901234abcd5678ef901234abcd",
  "chainId": 137,
  "token": "USDC",
  "decimals": 6
}
Returns 503 with { "error": { "code": "preflight_unsupported" } } when the chain implied by crypto_ticker has no escrow client registered, and 400 (invalid_request / corridor_unsupported) for bad input.