Overview
Split and merge operations allow you to convert between USDC and outcome tokens (YES/NO pairs):
- Split: Convert USDC into equal amounts of YES and NO tokens (1 USDC → 1 YES + 1 NO)
- Merge: Convert equal amounts of YES and NO tokens back into USDC (1 YES + 1 NO → 1 USDC)
Together, one YES token and one NO token always equal exactly $1.00 USDC. You can trade them independently or merge them back at any time.
splitShares
Splits USDC into equal amounts of YES and NO outcome tokens.
await client.splitShares({
marketAppId: 123456789,
amount: 1_000_000, // $1.00 in microunits
});
Parameters
Amount of USDC to split in microunits (e.g. 1_000_000 = $1.00)
Returns
Returns a Promise<SplitMergeResult>:
Whether the operation succeeded
Transaction IDs from the atomic group
Example
import { AlphaClient } from '@alpha-arcade/sdk';
import algosdk from 'algosdk';
const account = algosdk.mnemonicToSecretKey(process.env.MNEMONIC!);
const algodClient = new algosdk.Algodv2('', 'https://mainnet-api.algonode.cloud', 443);
const indexerClient = new algosdk.Indexer('', 'https://mainnet-idx.algonode.cloud', 443);
const client = new AlphaClient({
algodClient,
indexerClient,
signer: algosdk.makeBasicAccountTransactionSigner(account),
activeAddress: account.addr.toString(),
matcherAppId: 741347297,
usdcAssetId: 31566704,
});
// Split $0.50 USDC into YES + NO tokens
const splitResult = await client.splitShares({
marketAppId: 123456789,
amount: 500_000, // $0.50
});
console.log(`Split done! Round: ${splitResult.confirmedRound}`);
// Check positions
const positions = await client.getPositions();
const pos = positions.find((p) => p.marketAppId === 123456789);
if (pos) {
console.log(`YES balance: ${pos.yesBalance / 1e6}`);
console.log(`NO balance: ${pos.noBalance / 1e6}`);
}
mergeShares
Merges equal amounts of YES and NO tokens back into USDC. This is the inverse of split.
await client.mergeShares({
marketAppId: 123456789,
amount: 1_000_000, // Merge 1 YES + 1 NO = $1.00 USDC
});
Parameters
Amount to merge in microunits. This amount is deducted from both your YES and NO balances (e.g. 1_000_000 merges 1 YES + 1 NO → $1.00 USDC)
Returns
Returns a Promise<SplitMergeResult>:
Whether the operation succeeded
Transaction IDs from the atomic group
Example
import { AlphaClient } from '@alpha-arcade/sdk';
import algosdk from 'algosdk';
const account = algosdk.mnemonicToSecretKey(process.env.MNEMONIC!);
const algodClient = new algosdk.Algodv2('', 'https://mainnet-api.algonode.cloud', 443);
const indexerClient = new algosdk.Indexer('', 'https://mainnet-idx.algonode.cloud', 443);
const client = new AlphaClient({
algodClient,
indexerClient,
signer: algosdk.makeBasicAccountTransactionSigner(account),
activeAddress: account.addr.toString(),
matcherAppId: 741347297,
usdcAssetId: 31566704,
});
// Merge 0.5 YES + 0.5 NO back into $0.50 USDC
const mergeResult = await client.mergeShares({
marketAppId: 123456789,
amount: 500_000,
});
console.log(`Merge done! Round: ${mergeResult.confirmedRound}`);
Use Cases
- Risk-free profit extraction: If you have matching YES and NO tokens from arbitrage or market making, merge them to extract USDC without market exposure
- Reduce exposure: Convert paired positions back to cash
- Portfolio rebalancing: Exit markets while avoiding slippage from selling on the orderbook
