For the complete documentation index, see llms.txt. This page is also available as Markdown.

Prepare the borrower transaction

Returns unsigned calldata only while the drawdown is READY_FOR_SUBMISSION, or returns the same unexpired stored preparation for an idempotent retry. Preparations are valid for ten minutes. Preparation atomically moves the resource to SUBMITTING because the transaction may be broadcast immediately after this response.

The partner signs and broadcasts the returned transaction using the designated wallet. Qiro never receives a private key and this endpoint does not submit a blockchain transaction. The Qiro SDK can perform preparation, wallet submission, and immediate receipt verification as one client-side method.

post
Required scopes
This endpoint requires the following scopes:
  • : Create and prepare partner drawdowns.
Authorizations
OAuth2clientCredentialsRequired
Token URL:
Path parameters
drawdown_idstringRequired

Stable Qiro identifier for one partner drawdown workflow.

Example: drw_01J5T6CNR5ZEPattern: ^drw_[A-Za-z0-9]+$
Header parameters
X-Correlation-IDstring · min: 1 · max: 128Required

End-to-end request identifier. When the body contains correlation_id, both values must match.

Example: cor_drawdown_123
Responses
200

A short-lived unsigned transaction bound to the approved facility and wallet.

application/json
post/v1/drawdowns/{drawdown_id}/prepare
POST /v1/drawdowns/{drawdown_id}/prepare HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
X-Correlation-ID: text
Accept: */*
{
  "drawdown_id": "drw_01J5T6CNR5ZE",
  "status": "SUBMITTING",
  "expires_at": "2026-08-12T10:40:00Z",
  "transaction": {
    "chain_id": 421614,
    "to": "0x57923bc2f063a06abc88a1a1c49109191034246e",
    "data": "0x1234abcd",
    "value": "0"
  }
}

Last updated