InternalTransferService

Create Internal Transfer

Create or return one authenticated Trading to Trading internal transfer.

Method

POST

Path

/v1/trading/internal-transfers

Visibility

Authentication required

Authentication

Session token or API key

MFA Requirement

Conditionally required

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 public subaccount ID. When omitted, subaccount-scoped API keys use their bound subaccount; other callers use their authenticated root 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

Key	HTTP status	Connect code	Error	When
unauthenticated	401	unauthenticated	Unauthenticated	Authentication required.
permission-denied	403	permission_denied	Permission Denied	Permission denied.
invalid-argument	400	invalid_argument	Invalid Argument	Invalid argument.
not-found	404	not_found	Not Found	Not found.
unavailable	503	unavailable	Unavailable	Service unavailable.

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"
}