# Trade links

A trade link opens Dumbify with the user's answers already filled in. It is a plain URL: no account, no key and no API call is needed to build one. Format version 1, frozen on 2026-11-07 (see the [changelog](https://www.dumbify.gg/docs/agents/changelog.md)).

A link never places a trade. The page prices the trade when it opens, and the user confirms it in their own browser with the usual checks. A link carries no account, no key and no price, so an old link shows a fresh price, or says why it can't trade now.

## Paths

| Path               | Opens                                                                                               |
| ------------------ | --------------------------------------------------------------------------------------------------- |
| `/play/new/ticket` | The trade ticket, with every answer filled in                                                       |
| `/play/new`        | The questions, at the first one without a valid answer (the start screen when there are no answers) |
| `/play/new/draw`   | Draw it: a price range turned into a spread (Bitcoin, Ether and Solana)                             |

All paths are on `https://www.dumbify.gg`.

## Parameters

Give each parameter once. Unknown parameters are ignored.

| Param    | Meaning                                             | Format and checks                                                                                                                                                                                                                                                         |
| -------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `moment` | The market                                          | `<underlying>-next-settlement`, lower case, for example `btc-next-settlement`. The market must be listed on Dumbify right now                                                                                                                                             |
| `view`   | The direction                                       | `higher`, `lower`, or `big_move` (a big move either way). Refused if that direction has no quotes right now                                                                                                                                                               |
| `settle` | When the trade settles                              | ISO-8601 UTC time of a quoted Paradex expiry, for example `2026-11-13T08:00:00.000Z`. Leave it out to take the first quoted one                                                                                                                                           |
| `target` | The price the view is about                         | A positive number; `$` and `,` are ignored. Above today's price for `higher` (below it for `lower`), far enough that a trade can pay. Not used with `big_move`                                                                                                            |
| `strike` | A drawn spread: the strike bought                   | Use with `sold`, `view` `higher` or `lower`, and `settle`. A strike listed at `settle`                                                                                                                                                                                    |
| `sold`   | A drawn spread: the strike sold                     | Use with `strike`. `higher` (call spread): `strike` below `sold`. `lower` (put spread): `strike` above `sold`. Then `target` and `spice` are not used                                                                                                                     |
| `budget` | The most the user will spend, in USD, fees included | A positive number with at most 2 decimals. Below the cheapest trade, the page asks again and names the cheapest amount. On a drawn spread (`strike` and `sold`) there is no such check: the ticket opens blocked, names what the smallest size costs, and places no trade |
| `spice`  | How far the trade reaches                           | `mild` (pays more often, but smaller), `medium`, or `hot` (needs a bigger move, pays more when it comes)                                                                                                                                                                  |
| `lower`  | Draw it: one end of the range                       | `/play/new/draw` only, with `moment` `btc-next-settlement`, `eth-next-settlement` or `sol-next-settlement`. A positive number                                                                                                                                             |
| `upper`  | Draw it: the other end of the range                 | `/play/new/draw` only. The two ends can come in either order; each snaps to a listed strike, and the page says so                                                                                                                                                         |
| `ch`     | Where the link came from                            | `agent` on every link an agent builds. `x`, `telegram` and `link` are set by Dumbify's own share buttons: on a share link you pass on, keep its `ch` as it is                                                                                                             |
| `r`      | A Dumbify referral code                             | 3 to 32 of `A-Z a-z 0-9 _ -`, not starting with `0x`. Never changes the trade                                                                                                                                                                                             |
| `via`    | A Dumbify user's share code                         | 10 to 64 of `A-Z a-z 0-9 _ -`, not starting with `0x`. Keep it only if the link you started from had one. It credits the sharer only with that link's own `ch` (`x`, `telegram` or `link`)                                                                                |
| `idea`   | The shared idea these answers come from             | 1 to 80 of `a-z 0-9 -`. Credits the idea's author; never changes the trade                                                                                                                                                                                                |

If an answer is missing or fails its check, the page opens at that question, so the user can fix it. An `r`, `via` or `ch` that fails its check is dropped from the link.

## Examples

Bitcoin above $110,000 by Friday 13 November 2026, $50 at most:

```text
https://www.dumbify.gg/play/new/ticket?moment=btc-next-settlement&view=higher&settle=2026-11-13T08:00:00.000Z&target=110000&budget=50&spice=medium&ch=agent
```

Ether makes a big move either way, $25 at most, first quoted settlement:

```text
https://www.dumbify.gg/play/new/ticket?moment=eth-next-settlement&view=big_move&budget=25&spice=mild&ch=agent
```

A call spread from $105,000 to $110,000 on Bitcoin, $50 at most:

```text
https://www.dumbify.gg/play/new/ticket?moment=btc-next-settlement&view=higher&settle=2026-11-13T08:00:00.000Z&strike=105000&sold=110000&budget=50&ch=agent
```

Draw it with a range, then the user picks the budget:

```text
https://www.dumbify.gg/play/new/draw?moment=btc-next-settlement&lower=105000&upper=110000&settle=2026-11-13T08:00:00.000Z&ch=agent
```

Start the questions with the market and direction, and let the user answer the rest:

```text
https://www.dumbify.gg/play/new?moment=sol-next-settlement&view=lower&ch=agent
```

## Notes

- `/play/` pages are closed to search crawlers in `robots.txt`. Fetching one page your user asked for is fine.
- Markets, dates and strikes change all the time. The page checks them when it opens, so a link built from stale data opens at the question that needs a new answer.
- To post a link (on X, for example), post its short link: `POST https://www.dumbify.gg/api/v1/links` with a preview's `previewId` or the same intent, or the MCP tool `short_link`, answers `https://www.dumbify.gg/t/<code>`. It redirects to the same ticket link, `ch=agent` included. See the [agent guide](https://www.dumbify.gg/docs/agents.md).
- To build a link from current data, read the market first with `GET /api/v1/markets/{moment}` (see the [agent guide](https://www.dumbify.gg/docs/agents.md)): `settle` is one of its `settlements[].expiryAt`. A good `POST /api/v1/previews` answers with a ready link in `links.ticket`.
