Get Internal Transfer History

#Get Internal Transfer History

Returns internal transfer history for the authenticated account.

#Endpoint

GET /v1/internal_transfer_history

Mainnet: GET https://api.orderly.org/v1/internal\\_transfer\\_history\\ Testnet: GET https://testnet-api.orderly.org/v1/internal\\_transfer\\_history

Rate limit: 10 requests per second.

#Headers

• orderly-timestamp (string, required): Signed request timestamp in milliseconds.
• orderly-account-id (string, required): Authenticated account ID.
• orderly-key (string, required): Public key used to sign the request.
• orderly-signature (string, required): Signature of the request payload.

#Query parameters

• status (string): Filter by CREATED, PENDING, COMPLETED, or FAILED.
• start_t (string): Start time filter.
• end_t (string): End time filter.
• page (number): Page number, starting at 1.
• size (number): Number of records per page.
• side (string, required): IN or OUT.
• from_account_id (string): Filter by sender account.
• to_account_id (string): Filter by recipient account.
• main_sub_only (boolean): true returns transfers between the main account and its sub-accounts; false returns transfers between the main account and other main accounts; omit to return all transfer history.

#Response

HTTP 200 returns success, data.meta, data.rows, and timestamp. Metadata contains total, records_per_page, and current_page (starting at 1). Each row can contain internal_transfer_request_id (number), id (string), token (string), amount (number), from_account_id and to_account_id (strings), status (string), and created_time and updated_time (numbers in milliseconds).

{"success":true,"data":{"meta":{"total":9,"records_per_page":25,"current_page":1},"rows":[{"internal_transfer_request_id":123,"id":"230707030600002","token":"USDC","amount":555,"from_account_id":"0x000000","to_account_id":"0x000000","status":"FAILED","created_time":1688699193034,"updated_time":1688699193034}]},"timestamp":1702989203989}