TESTNET
Connect

InternalTransferService

Create Internal Transfer

Create or return one authenticated Trading to Trading internal transfer.

POST
/v1/trading/internal-transfers

Request

Testnet 
curl --request POST \ \
  --url 'https://api.testnet.polyester.com/v1/trading/internal-transfers' \
  --header 'Accept: */*' \
  --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \
  --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \
  --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": "18.446744073709551617",
  "assetId": 100,
  "destinationAccountId": "4Rh4iXdT",
  "idempotencyKey": "idem_01J5EXAMPLE0000000000000",
  "subaccountId": "45LUmqjT"
}'

Responses

{
  "acceptedAtTsNs": "1735689600000000000",
  "amount": "18.446744073709551617",
  "assetCode": "USDC",
  "assetId": 100,
  "destination": {
    "rootAccountPublicId": "7563897446546",
    "smartAccountAddress": "0x2222222222222222222222222222222222222222",
    "subaccountPublicId": "6789012345678"
  },
  "requestId": "request_01J0EXAMPLE",
  "status": "ACCEPTED",
  "transferId": "9155001234569",
  "uAssetId": "100"
}
amount string required /^[0-9]…9]+)?$/

Transfer amount in canonical 18-decimal unified asset units. For example, 0.5 is encoded as 500000000000000000.

assetId integer (int32)

Canonical public unified asset id for the asset being transferred.

destinationAccountId string /^[1-9A…m-z]+$/

Destination root account public id.

destinationSmartAccountAddress string

Destination smart-account address.

destinationSubaccountId string /^[1-9A…m-z]+$/

Destination subaccount public id.

idempotencyKey string

Stable client-supplied idempotency key used to collapse safe retries.

subaccountId string /^[1-9A…m-z]+$/

Optional source subaccount public id. When omitted, the authenticated caller's root account is used as the source account.

acceptedAtTsNs string /^[0-9]+$/

Acceptance timestamp in nanoseconds since epoch (server time).

Example 1735689600000000000
amount string /^[0-9]…9]+)?$/

Echoed transfer amount in canonical 18-decimal unified asset units.

Example 18.446744073709551617
assetCode string

Resolved asset code for convenience.

Example USDC
assetId integer (int32)

Echoed canonical public unified asset id.

Example 100
3 fields
requestId string

Stable server-owned request identifier for this intake.

Example request_01J0EXAMPLE
status enum

Public status for the transfer request.

ACCEPTED REJECTED FAILED
Example ACCEPTED
transferId string

Stable transfer identifier for the settled internal transfer.

Example 9155001234569
uAssetId string

Resolved unified asset id used by downstream settlement.

Example 100
Possible errors: 5
KeyStatusErrorWhen
unauthenticated401UnauthenticatedAuthentication required.
permission-denied403Permission DeniedPermission denied.
invalid-argument400Invalid ArgumentInvalid argument.
not-found404Not FoundNot found.
unavailable503UnavailableService unavailable.