Skip to main content
POST
/
v1
/
rfq
curl --request POST \
  --url https://api.firmament.shaikazeem.com/v1/rfq \
  --header 'Content-Type: application/json' \
  --data '
{
  "input_asset": "USDC",
  "output_asset": "SOL",
  "amount": "1.00",
  "taker_wallet": "11111111111111111111111111111111"
}
'
{
  "status": "accepted",
  "quote_id": "018f5a45-822c-7f42-9d18-9df9f88c5c7a",
  "quoted_output_amount_raw": 7200000,
  "spread_bps": 35,
  "expires_at": "2026-05-08T12:00:30Z",
  "htlc_terms": {
    "settlement_model": "solana_htlc",
    "escrow_mint": "So11111111111111111111111111111111111111112",
    "expires_at": "2026-05-08T12:00:30Z",
    "hashlock": null
  },
  "risk_checks": [
    "max_notional_ok",
    "inventory_quoteable"
  ],
  "integration_status": "runtime_orchestrated",
  "pair": {
    "input_asset": "USDC",
    "output_asset": "SOL"
  },
  "input": {
    "asset": "USDC",
    "amount": "1.000000",
    "amount_raw": "1000000",
    "decimals": 6,
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
  },
  "output": {
    "asset": "SOL",
    "amount": "0.007200000",
    "amount_raw": "7200000",
    "decimals": 9,
    "mint": "So11111111111111111111111111111111111111112"
  },
  "next_action": {
    "type": "start_wallet_settlement",
    "method": "POST",
    "path": "/v1/quotes/018f5a45-822c-7f42-9d18-9df9f88c5c7a/wallet-settlement"
  }
}

Body

application/json
​
input_asset
string
required

Case-insensitive asset id or symbol (e.g. USDC, usdc).

Example:

"USDC"

​
output_asset
string
required
Example:

"SOL"

​
amount
string
required

Decimal amount in the input asset's display units, sent as a string.

Example:

"1.00"

​
taker_wallet
string
required

Solana wallet address.

Example:

"11111111111111111111111111111111"

​
expiry_seconds
integer
Required range: x >= 1
Example:

30

Response

Accepted quote terms or a risk rejection.

​
status
string
required
Allowed value: "accepted"
​
quote_id
string<uuid>
required
​
quoted_output_amount_raw
integer<int64>
required
Required range: x >= 0
Example:

1000

​
spread_bps
integer
required
Required range: 0 <= x <= 10000
Example:

35

​
expires_at
string<date-time>
required
​
htlc_terms
object
required
​
risk_checks
string[]
required
​
integration_status
enum<string>
required
Available options:
runtime_orchestrated
​
pair
object
required
​
input
object
required
​
output
object
required
​
next_action
object
required