Skip to content
Openfish Docs

Accept an RFQ Quote

When you supply only rfqId, the server automatically selects the most favorable non-expired PENDING quote: the lowest price for BUY-side requests and the highest price for SELL-side requests. All competing quotes are then rejected. Alternatively, specify quoteId to accept a particular quote directly.

Endpoint

Section titled “Endpoint”
POST /rfq/accept

Server: https://api.openfish.fun

Authentication: L2 (HMAC) required

Request Body

Section titled “Request Body”

Content-Type: application/json

Supply either rfqId (auto-selects the best quote) or quoteId (accepts a specific quote).

FieldTypeRequiredDescription
rfqIdstring (UUID)NoRFQ ID — auto-selects best quote
quoteIdstring (UUID)NoQuote ID — accepts this specific quote

Example: Auto best-quote

Section titled “Example: Auto best-quote”
{ "rfqId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }

Example: Direct quote acceptance

Section titled “Example: Direct quote acceptance”
{ "quoteId": "f1e2d3c4-b5a6-7890-fedc-ba0987654321" }

Responses

Section titled “Responses”

200 — Quote accepted

Section titled “200 — Quote accepted”
FieldTypeDescription
quoteIdstringAccepted quote UUID
rfqIdstringParent RFQ UUID
statusstring"ACCEPTED"
{
  "quoteId": "f1e2d3c4-b5a6-7890-fedc-ba0987654321",
  "rfqId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "ACCEPTED"
}

400 — Bad Request

Section titled “400 — Bad Request”
{ "error": "rfqId or quoteId required" }

404 — Not Found

Section titled “404 — Not Found”
{ "error": "no valid quotes available" }

401 — Unauthorized

Section titled “401 — Unauthorized”
{ "error": "invalid authorization" }