> ## Documentation Index > Fetch the complete documentation index at: https://guides.saber.money/llms.txt > Use this file to discover all available pages before exploring further. # Create Pool Buy Transaction > Create a pool buy transaction. **Price lock (`quote_id`)** Pass `quote_id` to create this transaction against a price-locked quote previously issued by the Pool Buy Quote endpoint (`POST /api/v2/wallet/p/quote`). When `quote_id` is supplied, the locked currency pair, payment method, amounts, and fees are resolved from the stored quote; the matching request fields become optional and any values sent for them are ignored. When `quote_id` is absent the endpoint behaves as before and the original fields remain required. ```json { "quote_id": "421b9fb7-6800-4d9d-ba17-083ad662733b", "source_id": "94b00193-301d-4750-b310-207393d987c9", "bank_transaction_id": "501610337776" } ``` **Response field values** | Field | Possible Values | | --- | --- | | `transaction_type` | `POOL_BUY` | | `status` | Typically `PROCESSING` immediately after creation | ## OpenAPI ````yaml openapi-v2.json POST /api/v2/wallet/transaction/pool/buy openapi: 3.1.0 info: title: Saber Money API (v2) version: v2 description: >- ## Authentication There is no standalone API-key auth — every request must be **signed**. An API key by itself authenticates nothing. Each call requires four headers together: `X-Api-Key` (your key), `X-Signature` (HMAC-SHA256 of `apiKey + timestamp` — or `apiKey + timestamp + userId` when `X-User-Id` is required — keyed with your API secret), `X-Timestamp` (unix seconds), and `X-Request-Id` (any unique string per request). The signature must be computed by a client script; there is no way to derive it by hand. Use the HMAC Generator flow to compute valid values for manual testing. ## Common Authentication Errors - **Invalid Client ID**: {"error_code":6092,"message":"X-Client-Id invalid","success":false} - **Invalid Secret**: {"error_code":6090,"message":"invalid secret","success":false} - **Timestamp (Older than 10 secs)**: {"errors":{"error_code":6093,"text":"timestamp expired"},"success":false} servers: - url: https://api.saber.money security: [] paths: /api/v2/wallet/transaction/pool/buy: post: tags: - Onramp summary: Create Pool Buy Transaction description: > Create a pool buy transaction. **Price lock (`quote_id`)** Pass `quote_id` to create this transaction against a price-locked quote previously issued by the Pool Buy Quote endpoint (`POST /api/v2/wallet/p/quote`). When `quote_id` is supplied, the locked currency pair, payment method, amounts, and fees are resolved from the stored quote; the matching request fields become optional and any values sent for them are ignored. When `quote_id` is absent the endpoint behaves as before and the original fields remain required. ```json { "quote_id": "421b9fb7-6800-4d9d-ba17-083ad662733b", "source_id": "94b00193-301d-4750-b310-207393d987c9", "bank_transaction_id": "501610337776" } ``` **Response field values** | Field | Possible Values | | --- | --- | | `transaction_type` | `POOL_BUY` | | `status` | Typically `PROCESSING` immediately after creation | operationId: create-pool-buy-transaction-v2 parameters: - name: X-Api-Key in: header required: true description: Your API key (configured in credentials) schema: type: string - name: X-Signature in: header required: true description: >- HMAC-SHA256 signature (auto-generated) To test manually: HMAC-SHA256 of `apiKey + timestamp` (or `apiKey + timestamp + userId` when X-User-Id is required), keyed with your API secret. The HMAC Generator flow computes this for you. schema: type: string - name: X-Timestamp in: header required: true description: >- Unix timestamp in seconds (auto-generated) Unix seconds, e.g. `Math.floor(Date.now() / 1000)`. Must match the timestamp used in the X-Signature computation. schema: type: string - name: X-Request-Id in: header required: true description: >- Unique request identifier (auto-generated) Any unique string per request, e.g. a UUID. schema: type: string - name: X-User-Id in: header required: true description: User UUID (set above) schema: type: string requestBody: required: true content: application/json: schema: type: object properties: quote_id: type: string description: >- Optional UUID of a price-locked quote from the Pool Buy Quote endpoint. When provided, the price-lock flow is enabled: `from_currency`, `to_currency`, `payment_method`, `from_amount`, and `to_amount` are taken from the quote and any values sent for them are ignored. The quote must be unexpired, unused, belong to the calling client, and match this transaction type. payment_method: type: string description: >- Deposit payment method. Ignored when `quote_id` is provided (taken from the quote). from_currency: type: string description: >- Fiat or source currency. Ignored when `quote_id` is provided (taken from the quote). to_currency: type: string description: >- Crypto or destination currency. Ignored when `quote_id` is provided (taken from the quote). from_amount: type: number description: >- Source amount. Must be greater than zero. Ignored when `quote_id` is provided (taken from the quote). to_amount: type: number description: >- Optional destination amount. Ignored when `quote_id` is provided (taken from the quote). uuid: type: string description: Optional client reference UUID. source_id: type: string description: Optional source instrument id. bank_transaction_id: type: string description: Optional provider reference. verification_code: type: string description: Payment verification code when applicable. cvv: type: string description: Card CVV when applicable. store_for_future_use: type: boolean description: Save payment method for future use. required: - payment_method - from_currency - to_currency - from_amount example: from_currency: EUR to_currency: USDT from_amount: 12 payment_method: open_banking responses: '200': description: Successful response content: application/json: schema: type: object properties: success: type: boolean data: type: object properties: id: type: string transaction_type: type: string enum: - POOL_BUY status: type: string enum: - PROCESSING fiat_amount: type: - string - integer crypto_amount: type: - string - number fiat_symbol: type: string crypto_symbol: type: string exchange_rate: type: - string - number failure_code: type: string failure_desc: type: string created_at: type: integer _links: type: - string - 'null' redirect_url: type: string payment_intent: type: string example: success: true data: id: 019680e1-c74f-79b7-9a0b-cc316731bfd4 transaction_type: POOL_BUY status: PROCESSING fiat_amount: 12 crypto_amount: 13.01 fiat_symbol: EUR crypto_symbol: USDT exchange_rate: 0.9223 failure_code: '' failure_desc: '' created_at: 1774346040000 _links: null redirect_url: '' payment_intent: '' '400': description: >- `400`: missing or invalid parameters; `400`: from_amount should be greater than 0; `402002`: quote expired; `402003`: settlement window expired; `402004`: quote already used; `402005`: quote invalid; `402006`: first party status mismatch; `402007`: quote doesn't belong to the client content: application/json: schema: type: object properties: success: type: boolean enum: - false errors: type: array items: type: object properties: code: type: - integer - string text: type: string example: success: false errors: - code: 400 text: from_amount should be greater than 0 '409': description: '`403004`: reference uuid already exists or is invalid' content: application/json: schema: type: object properties: success: type: boolean enum: - false errors: type: array items: type: object properties: code: type: - integer - string text: type: string example: success: false errors: - code: 400 text: from_amount should be greater than 0 '500': description: '`499999`: Something went wrong!' content: application/json: schema: type: object properties: success: type: boolean enum: - false errors: type: array items: type: object properties: code: type: - integer - string text: type: string example: success: false errors: - code: 400 text: from_amount should be greater than 0 ```` ## Related topics - [Get Pool Buy Transaction Details](/api-reference/onramp/to-pool-wallet/get-pool-buy-transaction-details.md) - [Get List of Pool Buy Transactions](/api-reference/onramp/to-pool-wallet/get-list-of-pool-buy-transactions.md) - [Create Pool Sell Transaction](/api-reference/offramp/from-pool-wallet/create-pool-sell-transaction.md) - [Pool Buy Quote](/api-reference/onramp/price-lock/pool-buy-quote.md) - [Create External Buy](/api-reference/onramp/to-external-wallet/create-external-buy.md)