Get Orders History

The getOrdersHistory function retrieves the transaction history of orders placed by the authenticated user.

Available on

Ethereum

Polygon

Avalanche

Arbitrum

BSC

Fantom

Linea

Metis

Optimism

Base

Base Sepolia

HyperEVM Testnet

Polygon Amoy

To enable these chains for your application, please configure them in the Okto Dashboard.

Not available on

Example

import { useOkto } from '@okto_web3/react-sdk';
import { getOrdersHistory } from '@okto_web3/react-sdk'; 
 
function OrderHistory() {
    const oktoClient = useOkto();
 
    async function fetchOrderHistory() {
        try {
            const history = await getOrdersHistory(oktoClient); 
            console.log('Order history:', history);
        } catch (error) {
            console.error('Error fetching order history:', error);
        }
    }
 
    return (
        <button onClick={fetchOrderHistory}>
            Fetch Order History
        </button>
    );
}

Important: Transaction Lifecycle

The getOrderHistory function fetches the current status of a transaction on the Okto chain. However, the transaction status will continue to update on the Okto chain as it progresses through various stages in the Distributed Transaction Network (DTN).

To track a transaction to completion:

Keep fetching the order history for your specific jobId until the status shows "SUCCESSFUL"
Once successful, the transaction hash will be available in the response
Use this transaction hash to verify the transaction on the destination chain's explorer

Note

For error handling:

Use the error code to debug issues. Check out the SDK errors and warnings documentation
For help, navigate to the troubleshooting guide to contact support

Method Overview

Method	Description
_async `getOrdersHistory`	Get order history for the user