MasayumeDocs
Open app
Social and discovery

Trade from X

Link a handle to your wallet and fund a bounded mention executor.

Reviewed 2026-09-07

X-trade reads supported mentions and places calls from the Trading Balance of the wallet linked to your X account. You fund a limited executor first. Posting a mention from an unlinked account does not create a wallet or funded position for you.

The executor can open positions within the grant. It cannot withdraw the Vault balance to itself. Individual calls can still lose their stake.

Link your wallet and X accountMasayume

X-trade starts with the owner wallet connection. The funding and account-link steps continue below; the diagram illustrates the intended call path.

Capture state: Public masayume.app · signed out · X-trade setup begins with the owner wallet connection.

Captured .

  1. 1Use the shown bot handle and the required mention fields.
  2. 2Connect the wallet whose Trading Balance will fund calls.
  3. 3Continue to fund and authorize the bounded executor after connecting.

Link your wallet and X account

Masayume
Masayume X-trade setup for funding an executor and linking an X account.

X-trade starts with the owner wallet connection. The funding and account-link steps continue below; the diagram illustrates the intended call path.

Capture state: Public masayume.app · signed out · X-trade setup begins with the owner wallet connection.

Captured .

  1. 1Use the shown bot handle and the required mention fields.
  2. 2Connect the wallet whose Trading Balance will fund calls.
  3. 3Continue to fund and authorize the bounded executor after connecting.
Open original capture

Connect your wallet

Open Trade from X and choose Connect your wallet. Use the wallet you intend to fund on Somnia Shannon.

Fund + authorize the agent

Enter Amount to fund and read the permission receipt. The current setup uses that amount for its per-trade and per-day ceilings, allows up to eight open Windows and expires after 30 days.

Choose Fund + Authorize and confirm the required transactions. A first token approval can add a prompt. Topping up an existing grant can require a deposit followed by funding the grant; check both steps.

Choose Sign in with X. After OAuth returns, check the handle and choose Link @handle to this wallet. Sign the wallet message proving this link.

A signed-in X session alone is not the completed wallet link. Wait for @handle routes to this wallet.

Post a supported call

Mention the bot handle shown by this deployment with one asset, one side, one stake and one Window length. Read the execution receipt afterward.

Confirm all three X setup stepsMasayume

The connected owner completed wallet connection, executor funding and the X link. These three setup checks are separate from the receipt for each later instruction.

Capture state: Public masayume.app · connected owner wallet · all three setup checks complete; this does not establish the outcome of a later mention.

Captured .

  1. 1The funded executor and the linked X account are separate completed checks.

Confirm all three X setup steps

Masayume
X-trade setup with the owner wallet connected, Vault funded and agent authorized, and masayume_app linked to this wallet.

The connected owner completed wallet connection, executor funding and the X link. These three setup checks are separate from the receipt for each later instruction.

Capture state: Public masayume.app · connected owner wallet · all three setup checks complete; this does not establish the outcome of a later mention.

Captured .

  1. 1The funded executor and the linked X account are separate completed checks.
Open original capture

Mention format

Use the handle shown on the page in place of @handle:

@handle btc up 5 15m
@handle eth down $10 1h

The current parser accepts BTC or ETH and the Window lengths 1m, 5m, 15m, 1h, 4h. A listed instruction still needs a suitable live market and enough grant capacity at execution time.

Use one of each field. Multiple sides, assets, stakes or lengths are refused rather than guessed. long and short are accepted direction words for ordinary UP/DOWN; they do not request leverage. An extra like 3x is refused.

Check your receipts

Read the reply under your mention and the receipts on Trade from X. When a transaction is available, use its clickable link to open the Somnia explorer. A reply can also name the asset, side, Window length and its end time in UTC.

Message or receipt statusWhat it means
Instruction received / submittedYour instruction was recorded. This does not confirm a trade.
Order filled / filledThe order obtained a position. The market result comes later; this does not mean you won or received a payout.
No fill / nothing-filledThe transaction completed without booking a position. A successful transaction does not guarantee a fill.
Order reverted / revertedThe trade failed on-chain. Transaction gas may still have been spent.
Order not confirmed / refusedRead the reason and check your setup or receipt before trying another instruction.
Status needs checking / unknownThe outcome has not been established. Check the linked transaction for its latest result. If there is no transaction link, check the app before trying again.

Do not repeat an uncertain instruction just because the reply is missing or delayed. The original trade may still have been sent. See X reply troubleshooting.

Requested and spent amounts

Requested is the amount you named in your instruction. Spent is the actual booked cost of a filled order. These can differ: a request for 5 tUSDC does not prove that 5 tUSDC was spent.

Older receipts may retain only the requested amount. A filled reply without a spent amount has not established the exact cost for you; open its transaction to check. Small booked amounts keep their decimal places, so 0.000001 tUSDC is not shown as zero.

Replies with or without an image

The bot may attach a branded receipt image. Each image uses that instruction's saved sender, status, Window, amounts and full transaction hash when one is known. It is generated from the recorded facts; a later handle change does not relabel an earlier receipt. The text alongside it retains the clickable transaction link.

The bot's own receipt replies are excluded from new trading instructions. If repeated replies appear, inspect the original instruction and app receipt; another reply is not evidence of another trade.

If images are disabled or image preparation or upload fails, the reply can arrive as text with the same status and transaction link. Use that link to inspect the transaction. A picture is not required for the trade or its receipt.

Replies depend on the service being available. If X sign-in or trading is unavailable, follow the page's setup message. A missing reply does not establish that no trade happened; check the app's receipt first.

Read the service status

Mentions, Orders and Replies report different parts of the service. Last check passed means that part's recent check succeeded; it does not confirm your particular order. Standing by can mean there is no work. Not verified, Needs attention and Status out of date should not be interpreted as healthy operation.

The page shows when an image reply was last acknowledged, or says image delivery has not been verified. That evidence concerns a previous reply, not necessarily yours. If an order or reply needs inspection, check its receipt before sending another instruction. The service can recover an interrupted execution from matching chain evidence without placing the trade again.

Stop spending and take funds back

In Portfolio → X-Predict wallet, Cash out revokes the executor grant and returns its unspent budget to Trading Balance. To move that available amount into your wallet, open Trading Balance and choose Withdraw.

Disconnect X changes the account link; it does not move funds. Switch X account lets you change which account routes to the wallet after the required identity checks. Existing positions remain associated with their original owner.

If a top-up or setup fails after an earlier transaction succeeded, check the actual pool balance and receipt before depositing again.

Recover a linked wallet

  1. Open X recovery.
  2. Choose Sign in with X to reveal the wallet the account routes to.
  3. Connect that same wallet.
  4. Choose Open Portfolio to manage its Trading Balance and results.

The recovery page finds the linked wallet; it does not make a payout transaction. You still need the owner wallet to access its funds.

If the connected wallet differs, the page can offer Route @handle to this wallet instead, but the current server refuses that change while the account is still linked elsewhere. Connect the original linked wallet first. Signing in with X does not recover control of a wallet you no longer have.

Change the linked wallet

  1. Connect the wallet that X currently routes to and sign in to that same X account.
  2. Open Portfolio → X-Predict wallet, expand the account controls and choose Disconnect X. Sign the unlink message with the original wallet.
  3. Connect the new wallet, sign in with X again and complete its Link @handle to this wallet step.
  4. Set up the new wallet's executor funding separately before posting another call.

Unlinking changes the account route; it does not revoke the old grant or transfer its funds and positions. Use the old wallet's Cash out and Trading Balance Withdraw if you also want to remove its unspent budget. If there is no existing link at all, start through Trade from X.

Source notes

This guide follows the application code reviewed on 2026-09-07. Links point to that reviewed commit and require repository access. GitHub may show 404 if you are signed out or do not have access.

On this page