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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# İşlemler API'si

> İşlem, bir hesabın veya kullanıcının Whop tarafından yönetilen cüzdanı üzerindeki tek bir taleptir.

Bir perpetual üzerindeki `order`, alım satım bakiyesinden işlem yapar ve bakiye yetersizse ihtiyaç duyduğu USDT0'ı önce cüzdandan köprüler; spot üzerindeki `order`, cüzdandaki USDT0 ile varlık arasında takas yapar. `close`, tek bir piyasadaki pozisyonun tamamını kapatır; hesapta ardından açık pozisyon kalmadığında bir `withdraw` işlemi alım satım bakiyesini cüzdana geri gönderir. `deposit` veya `withdraw`, parayı cüzdan ile alım satım bakiyesi arasında taşır. Perpetual'lar Hyperliquid üzerinde işlem görür.

İşlemler API'sini işlem yapabileceğiniz piyasaları listelemek, emir vermek, pozisyonları kapatmak ve fon taşımak ve her işlemi bitene kadar takip etmek için kullanın. İşlemler arka planda çalışır; para köprüleyen ve gerçekleşmeyen bir emir o parayı cüzdana geri gönderir ve `funds_location` paranın nerede olduğunu söyler.

Hesaplar ve kullanıcılardaki `include_trading` dahil alım satım API'si beta aşamasındadır. Yeni bir API sürüm tarihi olmadan değişebilir.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [İşlemleri Listele](https://docs.whop.com/tr/api-reference/trades/list-trades.md) | GET `/trades` |
| [İşlemi Al](https://docs.whop.com/tr/api-reference/trades/retrieve-trade.md) | GET `/trades/{id}` |
| [Mumları Listele](https://docs.whop.com/tr/api-reference/trades/list-candles.md) | GET `/trades/candles` |
| [Piyasaları Listele](https://docs.whop.com/tr/api-reference/trades/list-markets.md) | GET `/trades/markets` |
| [İşlem Oluştur](https://docs.whop.com/tr/api-reference/trades/create-trade.md) | POST `/trades` |
| [İşlemi İptal Et](https://docs.whop.com/tr/api-reference/trades/cancel-trade.md) | POST `/trades/{id}/cancel` |

## Piyasalar

[Piyasaları Listele](https://docs.whop.com/tr/api-reference/trades/list-markets.md), Whop üzerinde işlem yapabileceğiniz her piyasayı döndürür.

* **Spot:** sembole göre listelenir: `BTC`, `SOL` ve `XAUT` (altın).
* **Perpetual'lar:** `BTC` gibi ve Hyperliquid'in `xyz` borsasındaki `xyz:TSLA` gibi hisse senedi ve emtia perpetual'ları. Bir işlem oluştururken `id` değerini `market` olarak gönderin.

Aynı sembol iki kez görünebilir, bir kez perpetual ve bir kez spot olarak; bu yüzden bunları ayırt etmek için `id` ile birlikte `instrument_type` kullanın. Sonuçlar `id`, ardından `instrument_type` değerine göre sıralanır.

Bu uç nokta herkese açıktır: API anahtarı gerekmez ve her IP adresi dakikada en fazla 60 istek yapabilir.

Bir perpetual emrinin `size` değeri en fazla `size_decimals` ondalık basamağa sahip olabilir ve `leverage` değeri en fazla `max_leverage` olabilir; bu değer spot piyasa için `null` olur.

```json theme={null}
[
	{
		"id": "BTC",
		"instrument_type": "perpetual",
		"max_leverage": 40,
		"size_decimals": 5,
		"price": {
			"currency": "usd",
			"amount": "80155.500000",
			"decimals": 6,
			"display_decimals": 6
		}
	},
	{
		"id": "BTC",
		"instrument_type": "spot",
		"max_leverage": null,
		"size_decimals": 5,
		"price": {
			"currency": "usd",
			"amount": "80065.50000000",
			"decimals": 8,
			"display_decimals": 8
		}
	}
]
```

Piyasa listesi, alım satım API'sinin geri kalanı gibi beta aşamasındadır ve yeni bir API sürüm tarihi olmadan değişebilir.

## Öznitelikler

**id** `string` *required*

`tint_` önekli işlem kimliği.

**account\_id** `string | null` *required*

Alım satım cüzdanının sahibi olan `biz_` önekli hesap. Bir kullanıcı sahibiyse
`null`.

**amount** `string | null` *required*

Bir yatırmanın, spot alımın veya alım satım bakiyesi yetersiz bir perpetual
emrinin cüzdandan gönderdiği USDT0 ya da bir çekimin geri gönderdiği USDC;
yerel birimlerde, ondalık dize olarak. `all` tutarındaki bir çekim, bittiğinde
ne gönderdiğini gösterir. Aksi takdirde `null`.

**average\_price** `string | null` *required*

Emrin USD cinsinden ortalama gerçekleşme fiyatı, ondalık dize olarak. Spot
için takasın teklif edildiği fiyat. Bilinmiyorsa `null`.

**client\_order\_id** `string | null` *required*

Çağıranın işlem için kendi kimliği, hesap için benzersiz. Gönderilmediyse
`null`.

**completed\_at** `string | null` *required*

İşlemin tamamlanmış veya başarısız olarak sona erdiği zaman, ISO 8601 zaman
damgası olarak. Öncesinde `null`.

**created\_at** `string` *required*

İşlemin oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**external\_order\_id** `string | null` *required*

Whop'un bu işlemin emriyle borsaya gönderdiği kimlik; böylece borsanın emir
güncellemeleri işlemle eşleştirilebilir. Hyperliquid'de, `orderUpdates`
içinde bildirilen emrin `cloid` değeridir; `0x` önekli 32 karakterlik bir hex
dizesidir. Çağıranın `client_order_id` değeri değildir. Yatırma veya çekim
için `null`.

**failure\_code** `string | null` *required*

İşlemin neden başarısız olduğu veya `null`.

Kullanılabilir seçenekler: `market_unavailable`, `leverage_too_high`, `amount_too_small`, `isolated_position_open`, `trading_paused`, `funding_failed`, `margin_unavailable`, `builder_fee_unapproved`, `leverage_rejected`, `leverage_unconfirmed`, `order_rejected`, `close_rejected`, `return_failed`, `withdraw_failed`

**filled\_size** `string | null` *required*

Emrin gerçekleşen büyüklüğü, piyasa birimlerinde, ondalık dize olarak. Spot
alım için takasın teslim etmek üzere teklif edildiği tutar. Gerçekleşene kadar `null`.

**funds\_location** `string | null` *required*

İşlem istendiği gibi tamamlanmadığında paranın nerede olduğu: `wallet`, `trading_account` veya bir kişi kontrol ederken `unknown`. Aksi takdirde `null`.

Kullanılabilir seçenekler: `wallet`, `trading_account`, `unknown`

**instrument\_type** `string | null` *required*

Bir emir için `perpetual` veya `spot`, kapatma için `perpetual`. Yatırma veya çekim için `null`.

Kullanılabilir seçenekler: `perpetual`, `spot`

**leverage** `integer | null` *required*

Pozisyon açan bir perpetual emrinden önce ayarlanan çapraz kaldıraç. Spot
emir, kapatma, yatırma, çekim veya yalnızca azaltma emri için `null`.

**market** `string | null` *required*

Piyasa, örneğin perpetual için `BTC` veya spot için `XAUT`. Yatırma veya
çekim için `null`.

**metadata** `object` *required*

İşlemde saklanan serbest biçimli dizeden dizeye açıklamalar.

**object** `string` *required*

**order\_type** `string | null` *required*

Bir emir için `market`, `limit`, `take_profit` veya `stop_loss`. Aksi takdirde `null`.

Kullanılabilir seçenekler: `market`, `limit`, `take_profit`, `stop_loss`

**parent\_id** `string | null` *required*

Bir emirle birlikte gönderilen kâr al veya zarar durdur için, o emrin `tint_`
önekli işlemi. Aksi takdirde `null`.

**price** `object | null` *required*

Emrin USD cinsinden limit fiyatı. Piyasa emrinin fiyatı, `slippage_bps` kadar kaydırılmış orta fiyattır; kâr al veya zarar durdur emrininki ise tetiklendikten sonra piyasa emrinin gerçekleşebileceği en kötü fiyattır. Diğer türler için `null`.

> [accordion] Özellikler
>
> **amount** `string` *required*
>
> Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin `"10.00"`
> on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için dizedir.
>
> **currency** `string` *required*
>
> Küçük harfli, üç harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı
> hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` ile eşittir, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

**reduce\_only** `boolean | null` *required*

Emrin yalnızca bir pozisyonu azaltıp azaltamayacağı. Diğer türler için `null`.

**side** `string | null` *required*

Bir emir için `buy` veya `sell`. Aksi takdirde `null`.

Kullanılabilir seçenekler: `buy`, `sell`

**size** `string | null` *required*

Piyasa birimlerinde emir büyüklüğü, ondalık dize olarak. Diğer türler için
`null`.

**status** `string` *required*

İşlem başlayana kadar `pending`. Çalışırken ve ayrıca gerçekleşmeyen bir emir köprülediği parayı cüzdana geri gönderirken `processing`. İsteneni yaptığında `completed`. Yapmadığında `failed`; `funds_location` paranın nerede olduğunu söyler. Sonuç bilinmediğinde ve bir kişi kontrol ederken `in_review`.

Kullanılabilir seçenekler: `pending`, `processing`, `in_review`, `completed`, `failed`

**status\_detail** `string | null` *required*

Emir büyüklüğünün yalnızca bir kısmı gerçekleştiğinde `partial_fill`. Aksi takdirde `null`.

Kullanılabilir seçenekler: `partial_fill`

**step** `string | null` *required*

Canlı bir işlemin şu anda ne yaptığı: cüzdandaki USDT0 köprüye gönderilirken `depositing`, gönderildikten sonra alım satım bakiyesine ulaşana kadar `landing`, emir veya kapatma işlem yerindeyken `placing`, USDC cüzdana geri dönerken `withdrawing`, gerçekleşmeyen bir emrin köprülediği para geri giderken `returning`. Bir spot emir, takas fiyatlandırılırken `quoting`, zincir üstünde çalışırken `swapping` ve yeni bakiye cüzdanda görünene kadar `crediting` durumundadır. İşlem artık beklemede veya işlemde olmadığında `null`.

Kullanılabilir seçenekler: `depositing`, `landing`, `placing`, `withdrawing`, `returning`, `quoting`, `swapping`, `crediting`

**trigger\_price** `object | null` *required*

Kâr al veya zarar durdur emrinin piyasa emrini gönderdiği USD cinsinden fiyat. Diğer emirler ve türler için `null`.

> [accordion] Özellikler
>
> **amount** `string` *required*
>
> Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin `"10.00"`
> on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için dizedir.
>
> **currency** `string` *required*
>
> Küçük harfli, üç harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı
> hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` ile eşittir, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

**type** `string` *required*

`order` tek bir emir verir: perpetual emri alım satım bakiyesinden işlem yapar, spot emri cüzdandaki USDT0 ile varlık arasında takas yapar. `deposit`, USDT0'ı cüzdandan alım satım bakiyesine köprüler. `withdraw`, USDC'yi alım satım bakiyesinden cüzdana geri gönderir. `close`, tek bir piyasadaki pozisyonun tamamını yalnızca azaltma piyasa emriyle kapatır; hesapta ardından açık pozisyon kalmadığında bir `withdraw` işlemi alım satım bakiyesini cüzdana geri gönderir.

Kullanılabilir seçenekler: `close`, `order`, `deposit`, `withdraw`

**updated\_at** `string` *required*

İşlemin en son değiştiği zaman, ISO 8601 zaman damgası olarak.

**user\_id** `string | null` *required*

Alım satım cüzdanının sahibi olan `user_` önekli kullanıcı. Bir hesap
sahibiyse `null`.

```json Trade theme={null}
{
	"id": "tint_xxxxxxxxxxxxx",
	"object": "trade",
	"type": "order",
	"status": "completed",
	"status_detail": null,
	"step": null,
	"account_id": "biz_xxxxxxxxxxxxxx",
	"user_id": null,
	"instrument_type": "perpetual",
	"market": "BTC",
	"side": "buy",
	"order_type": "market",
	"size": "0.00166",
	"price": {
		"currency": "usd",
		"amount": "60600.000000",
		"decimals": 6,
		"display_decimals": 6
	},
	"trigger_price": null,
	"reduce_only": false,
	"leverage": 5,
	"amount": null,
	"parent_id": null,
	"filled_size": "0.00166",
	"average_price": "60012.0",
	"funds_location": null,
	"failure_code": null,
	"client_order_id": "my-btc-entry-1",
	"external_order_id": "0x63cabad10f072c65ad84526e0c33081b",
	"metadata": {},
	"created_at": "2026-09-23T15:04:05.000Z",
	"updated_at": "2026-09-23T15:04:09.812Z",
	"completed_at": "2026-09-23T15:04:09.812Z"
}
```


## Related topics

- [Deneyler API'si](https://docs.whop.com/tr/api-reference/experiments/experiment.md)
- [Kartlar API'si](https://docs.whop.com/tr/api-reference/cards/card.md)
- [Kanallar API'si](https://docs.whop.com/tr/api-reference/channels/channel.md)
