Skip to main content
POST
/
transfers
Create Transfer
curl --request POST \
  --url https://api.otim.com/v0/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sourceAccountId": "<string>",
  "amount": "<string>",
  "destinationAccountId": "<string>",
  "counterpartyId": "<string>",
  "currency": "USDC",
  "description": "<string>"
}
'
{
  "id": "txfr_01JA1B2C3D4E5F6G7H8J9K0L",
  "status": "pending",
  "type": "book",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

API key prefixed with sk_.

Body

application/json
​
sourceAccountId
string
required

The ID of the Account to transfer from.

​
amount
string
required

The amount to transfer (e.g., 100.50).

​
destinationAccountId
string

The ID of the destination Account. Use this for book transfers between Accounts on the same Platform.

​
counterpartyId
string

The ID of the Counterparty to send funds to. Use this for transfers to external wallets or bank accounts.

​
currency
string
default:USDC

The currency to transfer. Defaults to USDC.

​
description
string

Optional description for the transfer.

Response

Transfer created.

​
id
string
Example:

"txfr_01JA1B2C3D4E5F6G7H8J9K0L"

​
status
string
Example:

"pending"

​
type
string
Example:

"book"

​
createdAt
string<date-time>