Build settlement orchestration

cURL

curl --request POST \
  --url https://api.otim.com/orchestration/build/settlement \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "acceptedTokens": {},
  "settlementChain": 123,
  "settlementToken": "<string>",
  "settlementAmount": 123,
  "recipientAddress": "<string>",
  "metadata": {},
  "payerAddress": "<string>",
  "dueDate": "2023-11-07T05:31:56Z",
  "maxRuns": 123
}
'

{
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "subOrgId": "<string>",
  "walletId": "<string>",
  "ephemeralWalletAddress": "<string>",
  "completionInstructions": [
    {
      "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
      "chainId": 11155111,
      "salt": 1234567890,
      "maxExecutions": 10,
      "action": "0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef",
      "arguments": "0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "actionName": "sweepDepositERC4626"
    }
  ],
  "instructions": [
    {
      "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
      "chainId": 11155111,
      "salt": 1234567890,
      "maxExecutions": 10,
      "action": "0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef",
      "arguments": "0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "actionName": "sweepDepositERC4626"
    }
  ]
}

POST

orchestration

build

settlement

cURL

curl --request POST \
  --url https://api.otim.com/orchestration/build/settlement \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "acceptedTokens": {},
  "settlementChain": 123,
  "settlementToken": "<string>",
  "settlementAmount": 123,
  "recipientAddress": "<string>",
  "metadata": {},
  "payerAddress": "<string>",
  "dueDate": "2023-11-07T05:31:56Z",
  "maxRuns": 123
}
'

{
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "subOrgId": "<string>",
  "walletId": "<string>",
  "ephemeralWalletAddress": "<string>",
  "completionInstructions": [
    {
      "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
      "chainId": 11155111,
      "salt": 1234567890,
      "maxExecutions": 10,
      "action": "0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef",
      "arguments": "0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "actionName": "sweepDepositERC4626"
    }
  ],
  "instructions": [
    {
      "address": "0xa0Ee7A142d267C1f36714E4a8F75612F20a79720",
      "chainId": 11155111,
      "salt": 1234567890,
      "maxExecutions": 10,
      "action": "0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef",
      "arguments": "0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "actionName": "sweepDepositERC4626"
    }
  ]
}

Build a settlement orchestration with ephemeral instructions. This endpoint automatically builds settlement orchestration instructions from simplified inputs: accepted tokens (grouped by chain), settlement amount, chain, and token, and recipient address.

Authorizations

Authorization

string

header

required

JWT token for API authentication

Body

application/json

acceptedTokens

object

required

Accepted tokens grouped by chain ID (chain_id -> list of token addresses)

Show child attributes

acceptedTokens.{key}

string<address>[]

settlementChain

integer<uint64>

required

Chain ID of the settlement chain

settlementToken

string<address>

required

Token address of the settlement token

settlementAmount

integer<uint256>

required

Settlement amount denominated in the settlement token

recipientAddress

string<address>

required

Address of the recipient

metadata

object

required

Orchestration metadata as arbitrary JSON

payerAddress

string<address> | null

Address of the payer

dueDate

string<date-time> | null

Due date for the orchestration

maxRuns

integer<uint64> | null

Maximum number of times the orchestration can be executed

Response

201 - application/json

Settlement orchestration built successfully

requestId

string<uuid>

required

Orchestration ID

subOrgId

string

required

Turnkey sub-organization ID

walletId

string

required

Turnkey wallet ID

ephemeralWalletAddress

string<address>

required

Ephemeral wallet address

completionInstructions

object[]

required

Completion instructions

Show child attributes

completionInstructions.address

string<address>

required

Address of the user

Example:

"0xa0Ee7A142d267C1f36714E4a8F75612F20a79720"

completionInstructions.chainId

integer<uint64>

required

Chain ID

Example:

11155111

completionInstructions.salt

integer<uint256>

required

Salt to ensure instruction is unique

Example:

1234567890

completionInstructions.maxExecutions

integer<uint256>

required

Maximum number of times this instruction can be executed (0 for unlimited)

Example:

10

completionInstructions.action

string<address>

required

Action contract address

Example:

"0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef"

completionInstructions.arguments

string<bytes>

required

Arguments to execute on the action contract

Example:

"0x0000000000000000000000001c7d4b196cb0c7b01d743fbc6116a902379c72380000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000a0Ee7A142d267C1f36714E4a8F75612F20a79720000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"

completionInstructions.actionName

enum<string>

required

Name of the action

Available options:

refuel,

transfer,

refuelERC20,

transferERC20,

uniswapV3ExactInput,

deactivateInstruction,

sweepCCTP,

transferCCTP,

sweep,

sweepERC20,

sweepUniswapV3,

depositERC4626,

sweepDepositERC4626,

withdrawERC4626,

sweepWithdrawERC4626,

callOnce

Example:

"sweepDepositERC4626"

instructions

object[]

required

Instructions

Show child attributes

instructions.address

string<address>

required

Address of the user

Example:

"0xa0Ee7A142d267C1f36714E4a8F75612F20a79720"

instructions.chainId

integer<uint64>

required

Chain ID

Example:

11155111

instructions.salt

integer<uint256>

required

Salt to ensure instruction is unique

Example:

1234567890

instructions.maxExecutions

integer<uint256>

required

Maximum number of times this instruction can be executed (0 for unlimited)

Example:

10

instructions.action

string<address>

required

Action contract address

Example:

"0x838c90f3e8d4892dCfA67721CbbA7C86D3C059ef"

instructions.arguments

string<bytes>

required

Arguments to execute on the action contract

Example:

instructions.actionName

enum<string>

required

Name of the action

Available options:

refuel,

transfer,

refuelERC20,

transferERC20,

uniswapV3ExactInput,

deactivateInstruction,

sweepCCTP,

transferCCTP,

sweep,

sweepERC20,

sweepUniswapV3,

depositERC4626,

sweepDepositERC4626,

withdrawERC4626,

sweepWithdrawERC4626,

callOnce

Example:

"sweepDepositERC4626"

Build orchestration Create orchestration

⌘I

Using the API

Otim APIs

Authorizations

Body

Response