API V2 Migration Guide

A comprehensive guide for migration from Okto V1 APIs to Okto V2 APIs.

This guide provides a detailed walkthrough for migrating your application from Okto V1 APIs to Okto V2 APIs. While the core API functionality remains unchanged, V2 implements a more decentralized architecture, and offering developers enhanced configurability and control over their integrations.

Key Changes Overview

AreaChanges
ArchitectureMoved to a more decentralized system with smart contracts on the Okto chain
AuthenticationOAuth-first approach with session key implementation
Wallet ManagementAutomated wallet creation across all enabled chains

Client-Side API Migration Table

V1 API RequestsV2 API RequestsChanges
POST /api/v2/authenticatePOST /api/v2/authenticateReturns session key on successful authentication
POST /api/v1/authenticate/emailComing Soon-
POST /api/v1/authenticate/email/verifyComing Soon-
POST /api/v1/authenticate/phoneComing Soon-
POST /api/v1/authenticate/phone/verifyComing Soon-
POST /api/v1/authenticate/whatsappComing Soon-
POST /api/v1/authenticate/whatsapp/verifyComing Soon-
POST /api/v1/authenticate/jwtComing Soon-
GET /api/v1/walletGET /api/oc/v1/walletsFetches all user wallets
POST /api/v1/walletDeprecatedWallets are auto-created.
POST /api/v1/refresh_tokenComing Soon-
POST /api/v1/logoutDeprecatedThe session key expires after 7 days.
GET /api/v1/user_from_tokenGET /api/oc/v1/verify-sessionNow returns detailed user information
GET /api/v1/supported/networksGET /api/oc/v1/supported/networksFetches details of all the enabled networks
GET /api/v1/supported/tokensGET /api/oc/v1/supported/tokensFetches details of all available tokens
GET /api/v1/portfolioGET /api/oc/v1/aggregated-portfolio-
GET /api/v1/portfolio/activityGET /api/oc/v1/portfolio/activity-
POST /api/v1/transfer/tokens/executeComing Soon-
GET /api/v1/ordersGET /api/oc/v1/ordersFetch all the orders for all transactions
GET /api/v1/portfolio/nftGET /api/oc/v1/portfolio/nft-
POST /api/v1/nft/transferComing Soon-
GET /api/v1/nft/order_detailsGET /api/oc/v1/ordersFetch all the orders for all transactions

Server API Reference

V1 API RequestsV2 API RequestsChanges
GET /s2s/api/v1/wallet`Coming Soon-
POST /s2s/api/v1/wallet`Coming Soon-
GET /s2s/api/v1/portfolio`Coming Soon-
GET /s2s/api/v1/portfolio/nft`Coming Soon-
GET /s2s/api/v1/portfolio/activity`Coming Soon-
GET /s2s/api/v1/supported/tokens`Coming Soon-
POST /s2s/api/v1/bulk-wallets`Coming Soon-
POST /s2s/api/v2/nft/mintComing Soon-
POST /s2s/api/v2/nft/transferComing Soon-
POST /s2s/api/v2/transfer/tokens/execute/Coming Soon-
GET /s2s/api/v2/bulk_order_details/Coming Soon-
POST /s2s/api/v1/readContractData`Coming Soon-
POST /s2s/api/v1/rawtransaction/execute/`Coming Soon-
GET /s2s/api/v1/rawtransaction/status/`Coming Soon-

Previous

Dev Tools

Next

Technical Reference

On this page