Skip to main content
GET
/
v1
/
quote
Get a live derived quote (not persisted)
curl --request GET \
  --url https://api.fiet.finance/v1/quote \
  --header 'Authorization: Basic <encoded-value>'
{
  "asOf": {
    "timestamp": "2023-11-07T05:31:56Z",
    "blockNumber": 123
  },
  "expiresAt": "2023-11-07T05:31:56Z",
  "chainId": 123,
  "tokenIn": "<string>",
  "tokenOut": "<string>",
  "amountIn": "<string>",
  "amountOut": "<string>",
  "fees": {},
  "route": {}
}
This endpoint returns a live derived quote. Quotes are not persisted as entities. For quoting semantics, see Quote.

Authorizations

​
Authorization
string
header
required

Basic Auth (assumed at gateway for MVP)

Query Parameters

​
chainId
integer<uint64>
required
Example:

1

​
tokenIn
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5fE4b"

​
tokenOut
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5fE4b"

​
tradeType
enum<string>
required
Available options:
EXACT_IN,
EXACT_OUT
​
amount
string
required

Amount (smallest units) as string. Interpretation depends on tradeType.

​
slippageBps
integer
default:50
Required range: 0 <= x <= 5000

Response

Quote

​
asOf
object
required
​
expiresAt
string<date-time>
required
​
chainId
integer<uint64>
required
Example:

1

​
tokenIn
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5fE4b"

​
tokenOut
string
required
Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f5fE4b"

​
tradeType
enum<string>
required
Available options:
EXACT_IN,
EXACT_OUT
​
amountIn
string
required

Exact input amount (smallest units as a string)

Example:

"1000000"

​
amountOut
string
required

Exact output amount (smallest units as a string)

Example:

"999000"

​
fees
object

Fee breakdown (protocol, gas estimate, etc.)

​
route
object

Router/path details (implementation-defined)