---
title: "Create an RFQ (scope: taker)"
method: POST
path: "/v1/rfqs"
---

# Create an RFQ (scope: taker)

`POST /v1/rfqs`

## Request

- Base URL: `https://api.hashlock.markets`
- URL: `https://api.hashlock.markets/v1/rfqs`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- CreateRfq
  - `direction` 'sell_base' | 'buy_base', required
  - `baseAssetId` string, required: asset uuid — list them with GET /v1/assets
  - `baseAmount` string, required: base units (integer string)
  - `quoteAssetId` string, required: asset uuid — list them with GET /v1/assets
  - `ttlSeconds` integer, required
  - `visibility` 'public' | 'private'
  - `askAmount` string
  - `targetAddress` string

## Response `201`

created

- object
  - `rfq` Rfq
    - `id` string
    - `direction` 'sell_base' | 'buy_base'
    - `baseAssetId` string: asset uuid — list them with GET /v1/assets
    - `baseAmount` string: base units
    - `quoteAssetId` string: asset uuid — list them with GET /v1/assets
    - `status` string
    - `expiresAt` string, date-time

## Other responses

- `400`: error
- `429`: rate limited

---

[API](https://skmtc.dev/hashlock/apis/hashlock-markets-api.md) · [All operations](https://skmtc.dev/hashlock/apis/hashlock-markets-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hashlock/apis/hashlock-markets-api/revisions/b85bd3992c46?raw)