POST
/
workspaces
/
{workspaceId}
/
intents
Create Intent request
curl --request POST \
  --url https://api.bron.org/workspaces/{workspaceId}/intents \
  --header 'Content-Type: application/json' \
  --data '{
  "accountId": "kqftx9zd3g6qdp09or",
  "fromAmount": "120.015",
  "fromAssetId": "2",
  "intentId": "w2u573pjj5wl975z4a9",
  "toAmount": "117500.03",
  "toAssetId": "5002"
}'
{
  "createdAt": "1794678400000",
  "expiresAt": "1758188560749",
  "fromAmount": "100.50",
  "fromAssetId": "2",
  "intentId": "rzsdziq1iknnzszmmtqz",
  "price": "101.2312",
  "status": "auction-in-progress",
  "toAmount": "0.0025",
  "toAssetId": "5002",
  "updatedAt": "1794764800000",
  "userSettlementDeadline": "1759188567456"
}

Path Parameters

​
workspaceId
string
required

Body

application/json
​
accountId
string
required

The id of the account where the intent transaction should be placed

Examples:

"kqftx9zd3g6qdp09or"

​
fromAssetId
string
required
Examples:

"2"

​
intentId
string
required

Unique intent identifier from client (should be unique per the account)

Examples:

"w2u573pjj5wl975z4a9"

​
toAssetId
string
required
Examples:

"5002"

​
fromAmount
string

The amount of asset that will be sent. Optional, one of fromAmount or toAmount must be specified.

Examples:

"120.015"

​
toAmount
string
Examples:

"117500.03"

Response

OK

​
createdAt
string
required

Creation timestamp of the intent (epoch millis)

Examples:

"1794678400000"

​
fromAssetId
string
required

ID of the asset being sent

Examples:

"2"

​
intentId
string
required

Unique user-generated ID of the intent

Examples:

"rzsdziq1iknnzszmmtqz"

​
status
enum<string>
required

Current status of the intent order. See details

Available options:
not-exist,
user-initiated,
auction-in-progress,
wait-for-oracle-confirm-user-tx,
wait-for-solver-tx,
wait-for-oracle-confirm-solver-tx,
completed,
liquidated,
cancelled
​
toAssetId
string
required

ID of the asset to receive

Examples:

"5002"

​
updatedAt
string
required

Last update timestamp of the intent (epoch millis)

Examples:

"1794764800000"

​
expiresAt
string

Expiration timestamp of the intent (epoch millis)

Examples:

"1758188560749"

​
fromAmount
string

Amount of the from-asset specified by the user

Examples:

"100.50"

​
price
string

Execution price of the swap (quote/base)

Examples:

"101.2312"

​
toAmount
string

Amount of the to-asset requested or estimated

Examples:

"0.0025"

​
userSettlementDeadline
string

Deadline timestamp for user settlement (epoch millis)

Examples:

"1759188567456"