Skip to main content
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": "<string>",
  "fromAssetId": "<string>",
  "intentId": "<string>",
  "toAssetId": "<string>",
  "fromAmount": "<string>",
  "toAmount": "<string>"
}
'
{
  "createdAt": "<string>",
  "fromAssetId": "<string>",
  "intentId": "<string>",
  "status": "not-exist",
  "toAssetId": "<string>",
  "updatedAt": "<string>",
  "expiresAt": "<string>",
  "fromAmount": "<string>",
  "price": "<string>",
  "toAmount": "<string>",
  "userSettlementDeadline": "<string>"
}

Path Parameters

​
workspaceId
string
required

Body

application/json
​
accountId
string
required

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

Example:

"kqftx9zd3g6qdp09or"

​
fromAssetId
string
required
Example:

"2"

​
intentId
string
required

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

Example:

"w2u573pjj5wl975z4a9"

​
toAssetId
string
required
Example:

"5002"

​
fromAmount
string

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

Example:

"120.015"

​
toAmount
string
Example:

"117500.03"

Response

OK

​
createdAt
string
required

Creation timestamp of the intent (epoch millis)

Example:

"1794678400000"

​
fromAssetId
string
required

ID of the asset being sent

Example:

"2"

​
intentId
string
required

Unique user-generated ID of the intent

Example:

"rzsdziq1iknnzszmmtqz"

​
status
enum<string>
required

Current status of the intent order. See details

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

"auction-in-progress"

​
toAssetId
string
required

ID of the asset to receive

Example:

"5002"

​
updatedAt
string
required

Last update timestamp of the intent (epoch millis)

Example:

"1794764800000"

​
expiresAt
string

Expiration timestamp of the intent (epoch millis)

Example:

"1758188560749"

​
fromAmount
string

Amount of the from-asset specified by the user

Example:

"100.50"

​
price
string

Execution price of the swap (quote/base)

Example:

"101.2312"

​
toAmount
string

Amount of the to-asset requested or estimated

Example:

"0.0025"

​
userSettlementDeadline
string

Deadline timestamp for user settlement (epoch millis)

Example:

"1759188567456"