Rift — RFQ / OTC Liquidity

Keyless, API-key-free RFQ and OTC liquidity venue. Request quotes with from/to/toAddress, create market orders from quotes with an idempotency key and refund authorizer. All 8 endpoints are public — no auth tokens required.

Upstream: api.rift.trade Auth: None (keyless) Execution: Hyperliquid, etc. Wildcard: /api/rift/*

Every path after /api/rift/ is forwarded to https://api.rift.trade/<path> verbatim — query params, body, and headers are preserved.

Health & Status

Method	Endpoint	Description
GET	`/api/rift/health`	API online status (`{status, timestamp}`)
GET	`/api/rift/status`	Execution provider dependency health
GET	`/api/rift/liquidity`	Available liquidity info

Quotes

Method	Endpoint	Body	Description
POST	`/api/rift/quote`	`from`, `to`, `toAddress` Optional: `fromAmount`, `orderType`, `amountFormat`	Create a market quote. Returns price + expiry.

Orders

Method	Endpoint	Description
GET	`/api/rift/orders`	List/fetch orders
GET	`/api/rift/order/{orderId}`	Get single order by ID
POST	`/api/rift/order/market`	Create market order from quote. Requires `quoteId`, `fromAddress`, `toAddress`, `idempotencyKey`, `refundAuthorizer`.
POST	`/api/rift/order/{orderId}/cancel`	Cancel order. Requires `refundToken` or `refundSignature` + `refundSignatureDeadline`.

Order Flow

Get a quote — POST /api/rift/quote with from/to/toAddress
Create market order — POST /api/rift/order/market with quoteId + idempotency key + refund authorizer
Check order status — GET /api/rift/order/{orderId}
Cancel if needed — POST /api/rift/order/{orderId}/cancel with refund credentials

Quick examples

# Check Rift is online
curl -s https://api.onimbus.cloud/api/rift/health

# Check liquidity
curl -s https://api.onimbus.cloud/api/rift/liquidity

# Create a quote (USDC → WETH on Arbitrum)
curl -s -X POST https://api.onimbus.cloud/api/rift/quote \
  -H 'content-type: application/json' \
  -d '{"from":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","to":"0x82aF49447D8a07e3bd95BD0d56f35241523fBab1","toAddress":"0xYOUR_WALLET","fromAmount":"1000000"}'

# Create market order from quote
curl -s -X POST https://api.onimbus.cloud/api/rift/order/market \
  -H 'content-type: application/json' \
  -d '{"quoteId":"QUOTE_ID","fromAddress":"0xSENDER","toAddress":"0xRECEIVER","idempotencyKey":"uuid-v4","refundAuthorizer":"0xRECEIVER"}'

# Check order status
curl -s https://api.onimbus.cloud/api/rift/order/ORDER_ID