Lock borrow bids (auction)

POST /v1/actions/term/bid

AUCTION BORROW — step 1 of 2. Build the lockBids transaction that submits sealed borrow bids (escrowing collateral) to the repo's active TermAuctionBidLocker. Reveal them via /v1/actions/term/reveal-bids.

Term Finance is a fixed-rate tri-party-repo lender (NOT a Morpho Blue fork) with two lend surfaces:

Secondary order book (RepoTokenLinkedList): buy/sell repo tokens continuously. LEND (buy a repo token) routes through the standard lending action /v1/actions/lending/deposit for a TERM_FINANCE_<id> market. List/cancel your own repo tokens with /v1/actions/term/list · /unlist, and read your listings + auction submissions from the unified /v1/data/lending/orders.
Primary auctions (sealed-bid): submit a lend offer or borrow bid, then reveal it. The endpoints in this section (/v1/actions/term/*) build those transactions.

Servicing (repay / redeem / collateral) always uses the standard lending actions: repay · withdraw · deposit (collateral leg).

Sealed commitments: offerPriceHash / bidPriceHash = keccak(price, nonce) are computed client-side so the server never sees your secret price/nonce before reveal.

Plain-text reference — POST /v1/actions/term/bid

Request body

Field	Type	Required	Description
`chainId`	string	yes	EVM chain id, as a decimal string. See the `ChainId` schema.
`lender`	string	yes	Protocol identifier. See the `LenderId` schema.
`submissions`	object[]	yes
`submissions[].id`	string	no	bytes32 — omit / zero for a new bid.
`submissions[].bidder`	string	yes	Bid owner address.
`submissions[].bidPriceHash`	string	yes	bytes32 commitment = `keccak(price, nonce)`, computed client-side.
`submissions[].amount`	string	yes	Borrow size in purchase-token units (integer wei).
`submissions[].collateralAmounts`	string[]	yes	Collateral amounts to escrow, aligned with `collateralTokens`.
`submissions[].collateralTokens`	string[]	yes	Collateral token addresses.
`submissions[].purchaseToken`	string	no	Optional; defaults to the repo's purchase token.
`referral`	string	no	Optional referral address.

Response 200

Field	Type	Description
`success`	`True`
`data`	object	Informational data (quotes, simulation results, etc.)
`actions`	object	Transaction calldata and approvals. Null for quote-only responses (no account provided).
`actions.transactions`	object[]	Pre-trade setup transactions (e.g. e-mode switch, collateral enable). Execute these before the main swap. Empty when no setup is needed.
`actions.transactions[].to`	string	Target contract address
`actions.transactions[].data`	string	Encoded calldata
`actions.transactions[].value`	string	ETH value to send with the transaction
`actions.transactions[].description`	string	Human-readable label. For `alternatives`, this is the aggregator name (e.g. "Paraswap"). For `transactions`, describes the setup action (e.g. "Switch e-mode to 1").
`actions.alternatives`	object[]	DEX aggregator swap transactions sorted by best output (descending). Each entry's `description` is the aggregator name. The client should pick one to execute. Present on loop action endpoints.
`actions.alternatives[].to`	string	Target contract address
`actions.alternatives[].data`	string	Encoded calldata
`actions.alternatives[].value`	string	ETH value to send with the transaction
`actions.alternatives[].description`	string	Human-readable label. For `alternatives`, this is the aggregator name (e.g. "Paraswap"). For `transactions`, describes the setup action (e.g. "Switch e-mode to 1").
`actions.permissions`	object[]	Approval/delegation transactions that must execute before both `transactions` and `alternatives`. Includes ERC20 allowances (targeting the composer contract) and lender borrow/withdrawal delegations (targeting the lending protocol contract directly). Filtered against on-chain state so only missing approvals are returned. Null when no approvals are needed.
`actions.permissions[].to`	string	Target contract address
`actions.permissions[].data`	string	Encoded calldata
`actions.permissions[].value`	string	ETH value
`actions.permissions[].description`	string	Human-readable description of the approval (e.g. "Approve borrow for AAVE_V3", "Approve ERC20")
`actions.permissions[].spender`	string	ERC-20 approve spender (x-chain permissions). Match it against the selected quote's `approvalTarget` — several bridges can share one spender, so do not match by description.

Example response

{
  "success": true,
  "data": {},
  "actions": {
    "transactions": [
      {
        "to": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
        "data": "0x617ba037000000000000000000000000c02aaa39b2",
        "value": "0",
        "description": "string"
      }
    ],
    "alternatives": [
      {
        "to": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
        "data": "0x617ba037000000000000000000000000c02aaa39b2",
        "value": "0",
        "description": "string"
      }
    ],
    "permissions": [
      {
        "to": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "data": "0x617ba037000000000000000000000000c02aaa39b2",
        "value": "0",
        "description": "string",
        "spender": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
      }
    ]
  }
}

Request

Responses

The lockBids transaction + per-collateral approvals

Rate limited. Unauthenticated callers share a per-IP budget; send an x-api-key header to lift it. Retry with exponential backoff.

An upstream data source or protocol origin failed (error.code is ORIGIN_FAILED). error.details carries the per-origin status. This is also what a missing or malformed required parameter currently returns, rather than a 400.

Lock borrow bids (auction)

/v1/actions/term/bid

Request​

Responses​

Request

Responses