> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openfinance.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Writing good Alchemy events

> A few small habits in how you word an event decide which market Alchemy matches. Here is how to phrase one, with plenty of examples you can copy as they are.

Whether you open a sample or type your own question, everything on the result follows from one choice: the Polymarket market Alchemy decides your event is about. The clearer the event, the better that match. A good event takes ten seconds to write and saves a paid run.

## What Alchemy does with your words

1. It reads the event and states it back in the first step, for example "Understood: Fed cuts rates in December". If you named a focus, such as "impact on tech", it adds that too.
2. It searches Polymarket with several short queries built from your words.
3. It picks a headline market, favoring markets that share your names and key words, that are still live, and that have real volume.

So names, dates and a clear outcome are what steer it.

## Five rules

Each rule below follows from how that search works.

**1. One outcome per run**

Ask about one thing that either happens or does not. Two events in one question get one muddled market.

**2. Give it a date**

"Before year end", "in December", "in 2027". Polymarket markets resolve on a date, and a dated event matches a dated market.

**3. Use names**

People, companies, countries and tickers are the strongest signal for finding the market. "Nvidia" beats "a big chipmaker".

**4. Make it measurable**

Prefer outcomes someone could settle: a rate cut, an election win, a price level, an earnings beat. "Markets get scary" cannot resolve.

**5. Add a focus only if you want one**

End with "impact on tech" or "impact on energy" to put that angle first in the trades. Leave it out to see the whole map.

## Good vs weak

Here is what the rules do to some real questions.

| Weak | Better | Why |
| - | - | - |
| what about AI stocks | Nvidia beats on earnings | One company, one outcome |
| rates | Fed cuts rates in December | A decision with a date |
| crypto going up? | Bitcoin new all-time high before year end | A level and a deadline |
| who wins the election and what happens to oil | JD Vance wins the 2028 election | One question per run; ask about oil separately |
| the economy is bad | US recession in 2027 | Measurable and dated |
| war stuff | Iran vs USA war impact | Names the countries |
| hacks | Market impact due to increase in cyber hacks | Says what you want: the market impact |

> [!TIP]
>
> If Alchemy shows "no market prices this yet", it still builds trades from related markets and instruments. Try rewording with a name or a date, or ask about a nearby event that does have a market.

## Events by theme

Copy one into the event box. Alchemy may not find a market for every event; when it does not, it says so on the summary card.

### Macro and rates

```text theme={"system"}
Fed cuts rates in December
```

```text theme={"system"}
US recession in 2027
```

### Politics and geopolitics

```text theme={"system"}
JD Vance wins the 2028 election
```

```text theme={"system"}
Iran vs USA war impact
```

### Tech and AI

```text theme={"system"}
Nvidia beats on earnings
```

```text theme={"system"}
Impact of AI Bubble crash
```

### Crypto

```text theme={"system"}
Bitcoin new all-time high before year end
```

```text theme={"system"}
Ethereum outperforms Bitcoin in 2027
```

### Weather, energy and security

```text theme={"system"}
Super El Niño this winter
```

```text theme={"system"}
Market impact due to increase in cyber hacks
```

### Sports

```text theme={"system"}
Real Madrid win the Champions League this season
```

```text theme={"system"}
Lakers win the 2027 NBA title
```

## Questions that work less well

Some questions are better asked somewhere else, or split up first.

* **Open questions.** "What should I buy?" has no outcome to price. Use Chat for that.
* **Single-asset orders.** "Long ETH 3x" is a trade, not an event. Chat or the Hyperliquid tools place it directly.
* **Long lists.** "Fed, oil, gold and the election" will pick one and drop the rest.
* **Side questions you did not mean.** Wording such as "by more than 10 points" or "how many seats" points Alchemy at a bracket market rather than the main one. Use it only when that is what you want.

## Before you send

* Is it one outcome?
* Is there a date?
* Is there a name?
* Could someone settle it as Yes or No?

If all four are yes, send it.

## Next

> [card] [Your first run](https://docs.openfinance.tech/alchemy/first-run.md)
>
> Try a free sample first.

> [card] [Reading a result](https://docs.openfinance.tech/alchemy/reading-results.md)
>
> Check what Alchemy matched your event to.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.