# Possible new booster api functions for multi-state puzzles

**URL:** https://forum.eternagame.org/t/possible-new-booster-api-functions-for-multi-state-puzzles/5674
**Category:** Feature Suggestions
**Tags:** booster-api, eternascript
**Created:** [December 31, 2025, 3:16am UTC](https://forum.eternagame.org/t/possible-new-booster-api-functions-for-multi-state-puzzles/5674 "2025-12-31T03:16:18Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![jandersonlee](https://forum.eternagame.org/letter_avatar_proxy/v4/letter/j/a9a28c/32.png) [@jandersonlee](https://forum.eternagame.org/u/jandersonlee)
#### Post date: [December 31, 2025, 3:16am UTC](https://forum.eternagame.org/t/possible-new-booster-api-functions-for-multi-state-puzzles/5674/1 "2025-12-31T03:16:18Z")

</div>

- `state_full_pairing_probabilities_async(index=0)`

- `state_full_subopt_async(index=0, kcalDelta=4.0)`

These new functions would help in the generation of dot plots and/or arc plots for multi-state puzzles and labs. The puzzles already encode all of the oglios and concentration, aptamers and bonuses, and other information into the states and the existing API does not make it easy (or in some cases, possible) to properly feed all of this back to the API folding functions; however, the game needs to be able to fold with these oglios/concentrations/aptamers/bonuses, so presumably the ability to do so may already be there, just not exported. The current pairing\_probablilities() function seemingly only works for a sequence without oglios, restricting the ability to compute dot plots for multi-state puzzles.

[Edit: I had proposed these a getters, but since the lab tool doesn’t normally need to compute these, I expect they should be async functions instead. Also, I understand that computing pairing probabilities with oglios and aptamer bonuses may be not be easy, but if suboptimal folding can be done (with oglios and aptamers) then a pairing probabilities can be estimated given a known bonus energy and aptamer constraint; it’s how the old arcplot service used to do it.]