{"openapi":"3.1.0","info":{"title":"Stard Market API","summary":"Public API for Telegram Stars, Premium, Gifts, NFTs, Usernames and Numbers on Stard Market","description":"مستندات کامل: https://stard-market.ir/docs — احراز هویت: Authorization: Bearer sk_live_… یا sk_test_…","version":"1.0.0"},"servers":[{"url":"https://stard-market.ir"}],"paths":{"/api/v1/ping":{"get":{"tags":["Public API v1"],"summary":"بررسی کلید","operationId":"ping_api_v1_ping_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/categories":{"get":{"tags":["Public API v1"],"summary":"دسته‌های محصول","operationId":"categories_api_v1_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/products":{"get":{"tags":["Public API v1"],"summary":"فهرست محصولات","operationId":"list_products_api_v1_products_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Category"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Search"}},{"name":"pricing_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Pricing Type"}},{"name":"min_price","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Min Price"}},{"name":"max_price","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Max Price"}},{"name":"purchasable","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Purchasable"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","maxLength":16,"default":"price_asc","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/products/tag/{tag}":{"get":{"tags":["Public API v1"],"summary":"محصول با تگ","operationId":"product_by_tag_api_v1_products_tag__tag__get","parameters":[{"name":"tag","in":"path","required":true,"schema":{"type":"string","title":"Tag"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/products/{ref}":{"get":{"tags":["Public API v1"],"summary":"یک محصول یا فهرست یک دسته","operationId":"product_or_category_api_v1_products__ref__get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Search"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","maxLength":16,"default":"price_asc","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/products/{product_id}/price":{"get":{"tags":["Public API v1"],"summary":"قیمت لحظه‌ای یک محصول","operationId":"product_price_api_v1_products__product_id__price_get","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prices":{"get":{"tags":["Public API v1"],"summary":"قیمت لحظه‌ای استارز، TON و دلار","operationId":"prices_api_v1_prices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/stars/price":{"get":{"tags":["Public API v1"],"summary":"قیمت تعداد مشخصی استارز","operationId":"stars_price_api_v1_stars_price_get","parameters":[{"name":"quantity","in":"query","required":false,"schema":{"type":"integer","maximum":1000000,"minimum":50,"default":50,"title":"Quantity"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/premium/prices":{"get":{"tags":["Public API v1"],"summary":"قیمت پلن‌های تلگرام پریمیوم","operationId":"premium_prices_api_v1_premium_prices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/marketplace":{"get":{"tags":["Public API v1"],"summary":"آمار بازار","operationId":"marketplace_api_v1_marketplace_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/auctions":{"get":{"tags":["Public API v1"],"summary":"مزایده‌های فعال","operationId":"auctions_api_v1_auctions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auctions/{product_id}":{"get":{"tags":["Public API v1"],"summary":"یک مزایده","operationId":"auction_api_v1_auctions__product_id__get","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/auctions/{product_id}/bids":{"get":{"tags":["Public API v1"],"summary":"پیشنهادهای یک مزایده (بدون هویت پیشنهاددهنده)","operationId":"auction_bids_api_v1_auctions__product_id__bids_get","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Public API v1","Marketplace"],"summary":"پیشنهاد قیمت روی مزایده یا آگهی توافقی","description":"پیشنهاد روی آگهی P2P (مزایده یا قیمت توافقی). برنده/پذیرفته‌شده مثل مینی‌اپ پیام می‌گیرد و خرید با امانت ادامه می‌یابد.","operationId":"place_bid_api_v1_auctions__product_id__bids_post","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BidApiIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wallet":{"get":{"tags":["Public API v1"],"summary":"موجودی کیف پول","operationId":"wallet_api_v1_wallet_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/transactions":{"get":{"tags":["Public API v1"],"summary":"تراکنش‌های کیف پول","operationId":"transactions_api_v1_transactions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orders":{"post":{"tags":["Public API v1"],"summary":"ثبت سفارش","operationId":"create_order_api_v1_orders_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Public API v1"],"summary":"سفارش‌های ثبت‌شده با API","operationId":"list_orders_api_v1_orders_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":24},{"type":"null"}],"description":"stars | product | smm | boost | star_reaction | …","title":"Type"},"description":"stars | product | smm | boost | star_reaction | …"},{"name":"created_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created After"}},{"name":"created_before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created Before"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orders/{ref}":{"get":{"tags":["Public API v1"],"summary":"یک سفارش","operationId":"get_order_api_v1_orders__ref__get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orders/{ref}/cancel":{"post":{"tags":["Public API v1"],"summary":"لغو سفارشی که هنوز شروع نشده","operationId":"cancel_order_api_v1_orders__ref__cancel_post","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orders/quote":{"post":{"tags":["Public API v1"],"summary":"پیش‌قیمت سفارش","operationId":"order_quote_api_v1_orders_quote_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/boosts":{"get":{"tags":["Public API v1"],"summary":"بوست کانال: مدت‌ها و قیمت","operationId":"boosts_catalog_api_v1_boosts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/boosts/price":{"get":{"tags":["Public API v1"],"summary":"قیمت دقیق بوست","operationId":"boosts_price_api_v1_boosts_price_get","parameters":[{"name":"quantity","in":"query","required":true,"schema":{"type":"integer","maximum":100000,"minimum":1,"title":"Quantity"}},{"name":"duration","in":"query","required":true,"schema":{"type":"integer","maximum":400,"minimum":1,"title":"Duration"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/boosts/orders":{"post":{"tags":["Public API v1"],"summary":"ثبت سفارش بوست","operationId":"boost_order_api_v1_boosts_orders_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoostOrderIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/boosts/orders/{ref}":{"get":{"tags":["Public API v1"],"summary":"وضعیت سفارش بوست","operationId":"boost_order_get_api_v1_boosts_orders__ref__get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gifts":{"get":{"tags":["Public API v1"],"summary":"گیفت‌های استارزی قابل ارسال","operationId":"gifts_list_api_v1_gifts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/gifts/send":{"post":{"tags":["Public API v1"],"summary":"ارسال گیفت استارزی به یک یوزرنیم","operationId":"gifts_send_api_v1_gifts_send_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftSendIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/gifts/orders/{ref}":{"get":{"tags":["Public API v1"],"summary":"وضعیت ارسال گیفت","operationId":"gifts_order_get_api_v1_gifts_orders__ref__get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/usernames/check":{"get":{"tags":["Public API v1"],"summary":"بررسی یوزرنیم در فروشگاه Stard","operationId":"usernames_check_api_v1_usernames_check_get","parameters":[{"name":"username","in":"query","required":true,"schema":{"type":"string","maxLength":40,"title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/usernames/{username}":{"get":{"tags":["Public API v1"],"summary":"یک یوزرنیم","operationId":"usernames_get_api_v1_usernames__username__get","parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string","title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/listings":{"get":{"tags":["Public API v1"],"summary":"آگهی‌های فعال بازار P2P (فقط خواندنی)","operationId":"listings_api_v1_listings_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/nfts/{slug}/history":{"get":{"tags":["Public API v1"],"summary":"سابقه‌ی فروش یک گیفت NFT","operationId":"nft_history_api_v1_nfts__slug__history_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/nfts/collections/{slug}/stats":{"get":{"tags":["Public API v1"],"summary":"آمار یک کالکشن NFT","operationId":"nft_collection_stats_api_v1_nfts_collections__slug__stats_get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/stats":{"get":{"tags":["Public API v1"],"summary":"آمار بازار گیفت‌ها و NFTها","operationId":"market_stats_api_v1_market_stats_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prices/history":{"get":{"tags":["Public API v1"],"summary":"تاریخچه‌ی قیمت استارز","operationId":"prices_history_api_v1_prices_history_get","parameters":[{"name":"interval","in":"query","required":false,"schema":{"type":"string","default":"1h","title":"Interval"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/products/{product_id}/price-history":{"get":{"tags":["Public API v1"],"summary":"تاریخچه‌ی قیمت یک محصول","operationId":"product_price_history_api_v1_products__product_id__price_history_get","parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"integer","title":"Product Id"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string","default":"1d","title":"Interval"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/price-alerts":{"get":{"tags":["Public API v1"],"summary":"فهرست هشدارهای قیمت","operationId":"alert_list_api_v1_price_alerts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["Public API v1"],"summary":"ساخت هشدار قیمت","operationId":"alert_create_api_v1_price_alerts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/price-alerts/{aid}":{"delete":{"tags":["Public API v1"],"summary":"حذف هشدار قیمت","operationId":"alert_delete_api_v1_price_alerts__aid__delete","parameters":[{"name":"aid","in":"path","required":true,"schema":{"type":"string","title":"Aid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orders/{ref}/refund":{"post":{"tags":["Public API v1"],"summary":"بازپرداخت سفارشی که هنوز شروع نشده","operationId":"order_refund_api_v1_orders__ref__refund_post","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Public API v1"],"summary":"وضعیت بازپرداخت سفارش","operationId":"order_refund_status_api_v1_orders__ref__refund_get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wallet/topups":{"post":{"tags":["Public API v1"],"summary":"درخواست شارژ موجودی TON","operationId":"wallet_topup_api_v1_wallet_topups_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopupIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wallet/topups/{memo}":{"get":{"tags":["Public API v1"],"summary":"وضعیت شارژ TON","operationId":"wallet_topup_get_api_v1_wallet_topups__memo__get","parameters":[{"name":"memo","in":"path","required":true,"schema":{"type":"string","title":"Memo"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/status":{"get":{"tags":["Public API v1"],"summary":"وضعیت سرویس‌های Stard","operationId":"service_status_api_v1_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/test/orders/{ref}/simulate":{"post":{"tags":["Public API v1"],"summary":"شبیه‌سازی نتیجه‌ی سفارش (فقط test)","operationId":"simulate_api_v1_test_orders__ref__simulate_post","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services":{"get":{"tags":["Public API v1"],"summary":"خدمات کانال: فهرست کامل","operationId":"services_list_api_v1_services_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/services/reactions/options":{"get":{"tags":["Public API v1"],"summary":"ری‌اکشن‌های قابل‌سفارش با قیمت","operationId":"services_reactions_api_v1_services_reactions_options_get","parameters":[{"name":"quantity","in":"query","required":false,"schema":{"type":"integer","maximum":1000000,"minimum":1,"default":100,"title":"Quantity"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services/{service}":{"get":{"tags":["Public API v1"],"summary":"جزئیات یک خدمت کانال","operationId":"services_get_api_v1_services__service__get","parameters":[{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services/{service}/options":{"get":{"tags":["Public API v1"],"summary":"گزینه‌های خدمت (ضمانت یا تعداد پست)","operationId":"services_options_api_v1_services__service__options_get","parameters":[{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}},{"name":"quantity","in":"query","required":true,"schema":{"type":"integer","maximum":1000000,"minimum":1,"title":"Quantity"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services/{service}/price":{"get":{"tags":["Public API v1"],"summary":"قیمت دقیق یک سفارش خدمت کانال","operationId":"services_price_api_v1_services__service__price_get","parameters":[{"name":"service","in":"path","required":true,"schema":{"type":"string","title":"Service"}},{"name":"quantity","in":"query","required":true,"schema":{"type":"integer","maximum":1000000,"minimum":1,"title":"Quantity"}},{"name":"reaction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"description":"شناسه از GET /services/reactions","title":"Reaction"},"description":"شناسه از GET /services/reactions"},{"name":"option","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"description":"شناسه از GET /services/{service}/options","title":"Option"},"description":"شناسه از GET /services/{service}/options"},{"name":"drip_runs","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":0,"description":"ارسال تدریجی: تعداد مرحله (۲ تا ۲۰)","default":0,"title":"Drip Runs"},"description":"ارسال تدریجی: تعداد مرحله (۲ تا ۲۰)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services/post-info":{"post":{"tags":["Public API v1"],"summary":"ری‌اکشن‌ها و اطلاعات فعلی یک پست","description":"status: done | pending (۱ تا ۳ ثانیه بعد دوباره بپرس) | not_found | unavailable","operationId":"services_post_info_api_v1_services_post_info_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostInfoIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services/orders":{"post":{"tags":["Public API v1"],"summary":"ثبت سفارش خدمت کانال","operationId":"services_order_api_v1_services_orders_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceOrderIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services/orders/{ref}":{"get":{"tags":["Public API v1"],"summary":"وضعیت سفارش خدمت کانال","operationId":"services_order_get_api_v1_services_orders__ref__get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/star-reactions/quote":{"get":{"tags":["Public API v1","Star reactions"],"summary":"قیمت ری‌اکشن استارزی","operationId":"star_reactions_quote_api_v1_star_reactions_quote_get","parameters":[{"name":"stars","in":"query","required":true,"schema":{"type":"integer","maximum":1000000,"minimum":1,"title":"Stars"}},{"name":"posts","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":1,"title":"Posts"}},{"name":"anonymous","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Anonymous"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/star-reactions/check":{"get":{"tags":["Public API v1","Star reactions"],"summary":"بررسی پست برای ری‌اکشن استارزی","operationId":"star_reactions_check_api_v1_star_reactions_check_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","maxLength":300,"title":"Url"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/star-reactions/orders":{"post":{"tags":["Public API v1","Star reactions"],"summary":"ثبت سفارش ری‌اکشن استارزی","operationId":"star_reactions_order_api_v1_star_reactions_orders_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StarReactionOrderIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/star-reactions/orders/{ref}":{"get":{"tags":["Public API v1","Star reactions"],"summary":"وضعیت سفارش ری‌اکشن استارزی","operationId":"star_reactions_order_get_api_v1_star_reactions_orders__ref__get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services/members/invite":{"post":{"tags":["Public API v1","Channel services"],"summary":"ممبر با ادمین کردن ربات (لینک دعوت خودکار)","description":"کاربر ربات را در کانال/گروه ادمین می‌کند (با مجوز «دعوت کاربران»)؛ ربات لینک دعوت اختصاصی می‌سازد و سفارش ممبر با همان\nلینک ثبت می‌شود. ورود/خروج اعضا از همین لینک شمرده می‌شود.","operationId":"members_invite_api_v1_services_members_invite_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberInviteIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services/members/invite/{token}":{"get":{"tags":["Public API v1","Channel services"],"summary":"وضعیت درخواست ممبر با ربات","operationId":"members_invite_get_api_v1_services_members_invite__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/services/orders/{ref}/members":{"get":{"tags":["Public API v1","Channel services"],"summary":"آمار ورود/خروج اعضای سفارش ممبر","operationId":"service_order_members_api_v1_services_orders__ref__members_get","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ton/rate":{"get":{"tags":["Public API v1","Prices"],"summary":"نرخ TON","operationId":"ton_rate_api_v1_ton_rate_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/wallet/convert/quote":{"get":{"tags":["Public API v1","Wallet"],"summary":"پیش‌نمایش تبدیل تومان ↔ TON","description":"نرخ لحظه‌ای، کارمزد، حداقل مبلغ، موجودی دو کیف پول و (اگر amount بیاید) مبلغ دقیق دریافتی.","operationId":"convert_quote_api_v1_wallet_convert_quote_get","parameters":[{"name":"direction","in":"query","required":true,"schema":{"type":"string","pattern":"^(toman_to_ton|ton_to_toman)$","title":"Direction"}},{"name":"amount","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"description":"toman_to_ton: تومان صحیح؛ ton_to_toman: TON اعشاری","title":"Amount"},"description":"toman_to_ton: تومان صحیح؛ ton_to_toman: TON اعشاری"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wallet/convert":{"post":{"tags":["Public API v1","Wallet"],"summary":"تبدیل تومان ↔ TON","description":"کسر از یک کیف پول و واریز به دیگری در یک تراکنش. <code>Idempotency-Key</code> الزامی است؛ تکرار همان کلید\nهمان نتیجه را برمی‌گرداند. اگر نرخ از <code>min_receive</code> بدتر شده باشد 409 و هیچ حرکتی.","operationId":"convert_api_v1_wallet_convert_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConvertApiIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wallet/ton/withdrawals/quote":{"get":{"tags":["Public API v1","Wallet"],"summary":"پیش‌نمایش برداشت TON","operationId":"withdraw_quote_api_v1_wallet_ton_withdrawals_quote_get","parameters":[{"name":"source","in":"query","required":true,"schema":{"type":"string","pattern":"^(ton|toman)$","description":"ton: از کیف TON | toman: با تبدیل تومان","title":"Source"},"description":"ton: از کیف TON | toman: با تبدیل تومان"},{"name":"amount","in":"query","required":true,"schema":{"type":"string","maxLength":32,"title":"Amount"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/wallet/ton/withdrawals":{"get":{"tags":["Public API v1","Wallet"],"summary":"برداشت‌های TON","operationId":"withdrawals_api_v1_wallet_ton_withdrawals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["Public API v1","Wallet"],"summary":"برداشت TON به کیف پولِ وصل‌شده","description":"مقصد همیشه کیف پولی است که مالک حساب با TON Connect وصل کرده (آدرس دلخواه پذیرفته نمی‌شود).\nبرداشت‌های بزرگ/غیرعادی مثل مینی‌اپ به صف بررسی می‌روند (<code>status=review</code>).","operationId":"withdraw_api_v1_wallet_ton_withdrawals_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawApiIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orders/{ref}/finalize":{"post":{"tags":["Public API v1","Marketplace"],"summary":"خرید P2P: پرداخت و شروع امانت","description":"وقتی فروشنده موجود بودن را تایید کرد (<code>raw_status=ready_to_finalize</code>)، مبلغ کسر و در امانت نگه داشته می‌شود.","operationId":"finalize_api_v1_orders__ref__finalize_post","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/orders/{ref}/receipt":{"post":{"tags":["Public API v1","Marketplace"],"summary":"خرید P2P: تایید یا رد دریافت","operationId":"receipt_api_v1_orders__ref__receipt_post","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","title":"Ref"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ton/sell/quote":{"get":{"tags":["Public API v1","TON"],"summary":"قیمت فروش TON (کیف به کیف یا کیف پول تلگرام)","description":"مبلغی که از کیف پول حساب کسر می‌شود تا گیرنده دقیقاً <code>amount_ton</code> بگیرد. قیمت هر تون = نرخ لحظه‌ای\n+ کارمزد هر تون استارد؛ کارمزد شبکه را استارد می‌پردازد. برای هر دو مقصد (آدرس و یوزرنیم) یکی است.","operationId":"ton_sell_quote_api_v1_ton_sell_quote_get","parameters":[{"name":"amount_ton","in":"query","required":true,"schema":{"type":"string","maxLength":24,"description":"مقداری که گیرنده دقیقاً می‌گیرد (حداقل 0.1)","title":"Amount Ton"},"description":"مقداری که گیرنده دقیقاً می‌گیرد (حداقل 0.1)"},{"name":"source","in":"query","required":false,"schema":{"type":"string","pattern":"^(toman|ton)$","description":"toman: از کیف تومانی | ton: از موجودی TON حساب","default":"toman","title":"Source"},"description":"toman: از کیف تومانی | ton: از موجودی TON حساب"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ton/sell":{"post":{"tags":["Public API v1","TON"],"summary":"ارسال TON به آدرس یا کیف پول تلگرام","description":"کسر از کیف پول حساب و ارسال TON.\n<ul><li><b>address</b>: کاملاً خودکار از کیف پول داغ استارد (معمولاً زیر یک دقیقه)؛ موارد غیرعادی به\n<code>status=review</code> می‌روند و بعد از بررسی ارسال یا کامل برگشت داده می‌شوند.</li>\n<li><b>telegram_username</b>: به کیف پول تلگرامِ همان یوزرنیم؛ توسط پشتیبانی ارسال می‌شود\n(<code>status=pending</code> → <code>done</code>، رد = برگشت کامل).</li></ul>\n<code>Idempotency-Key</code> (۸ تا ۶۴ کاراکتر) الزامی است؛ تکرار همان کلید همان پاسخ را برمی‌گرداند.","operationId":"ton_sell_api_v1_ton_sell_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TonSellIn"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["Public API v1","TON"],"summary":"ارسال‌های TON","operationId":"ton_sell_list_api_v1_ton_sell_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/ton/sell/{sell_id}":{"get":{"tags":["Public API v1","TON"],"summary":"یک ارسال TON","operationId":"ton_sell_get_api_v1_ton_sell__sell_id__get","parameters":[{"name":"sell_id","in":"path","required":true,"schema":{"type":"integer","title":"Sell Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AlertIn":{"properties":{"asset":{"type":"string","title":"Asset","description":"stars | ton | product"},"product_id":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Product Id"},"condition":{"type":"string","title":"Condition","description":"below | above"},"price":{"type":"integer","maximum":10000000000000.0,"minimum":1.0,"title":"Price","description":"قیمت هدف به تومان"}},"type":"object","required":["asset","condition","price"],"title":"AlertIn"},"BidApiIn":{"properties":{"amount":{"type":"integer","exclusiveMinimum":0.0,"title":"Amount","description":"مبلغ پیشنهاد (تومان)"}},"type":"object","required":["amount"],"title":"BidApiIn"},"BoostOrderIn":{"properties":{"recipient":{"type":"string","maxLength":120,"title":"Recipient","description":"@channel یا t.me/channel (کانال یا گروه عمومی)"},"quantity":{"type":"integer","maximum":100000.0,"minimum":1.0,"title":"Quantity"},"duration":{"type":"integer","maximum":400.0,"minimum":1.0,"title":"Duration"},"pay_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pay Currency","description":"TON یا IRT؛ پیش‌فرض: منبع داشبورد"},"quote_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Quote Id"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["recipient","quantity","duration"],"title":"BoostOrderIn"},"ConvertApiIn":{"properties":{"direction":{"type":"string","pattern":"^(toman_to_ton|ton_to_toman)$","title":"Direction"},"amount":{"type":"string","maxLength":32,"title":"Amount","description":"toman_to_ton: تومان صحیح | ton_to_toman: TON اعشاری"},"min_receive":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Min Receive","description":"محافظ لغزش نرخ: حداقل مبلغ دریافتی (واحد مقصد)"}},"type":"object","required":["direction","amount"],"title":"ConvertApiIn"},"GiftSendIn":{"properties":{"product_id":{"type":"integer","minimum":1.0,"title":"Product Id"},"recipient":{"type":"string","maxLength":64,"title":"Recipient","description":"@username گیرنده"},"message":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Message","description":"پیام روی گیفت"},"message_entities":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":50},{"type":"null"}],"title":"Message Entities","description":"entities پیام (مثل custom_emoji)"},"hide_sender":{"type":"boolean","title":"Hide Sender","description":"فرستنده‌ی مخفی (+۲٬۰۰۰ تومان)","default":false},"scheduled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled At","description":"زمان ارسال برنامه‌ریزی‌شده (ISO 8601)"},"pay_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pay Currency"},"quote_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Quote Id"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["product_id","recipient"],"title":"GiftSendIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"MemberInviteIn":{"properties":{"service":{"type":"string","pattern":"^(members|premium_members)$","title":"Service","default":"members"},"kind":{"type":"string","pattern":"^(channel|group)$","title":"Kind","description":"channel یا group"},"quantity":{"type":"integer","maximum":1000000.0,"minimum":1.0,"title":"Quantity"},"option":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Option","description":"سطح ضمانت از /services/{service}/options"},"drip_runs":{"type":"integer","maximum":20.0,"minimum":0.0,"title":"Drip Runs","default":0},"drip_interval":{"type":"integer","maximum":1440.0,"minimum":0.0,"title":"Drip Interval","default":0},"pay_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pay Currency","description":"TON یا IRT"},"max_price":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Price"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["kind","quantity"],"title":"MemberInviteIn"},"OrderIn":{"properties":{"type":{"type":"string","title":"Type","description":"product | stars","default":"product"},"product_id":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Product Id"},"quantity":{"type":"integer","maximum":1000000.0,"minimum":1.0,"title":"Quantity","description":"برای محصول همیشه ۱؛ برای استارز تعداد (حداقل ۵۰)","default":1},"recipient":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Recipient","description":"یوزرنیم گیرنده (برای استارز و گیفت الزامی)"},"gift_message":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Gift Message"},"hide_sender":{"type":"boolean","title":"Hide Sender","description":"فرستنده‌ی مخفی (فقط گیفت استارزی؛ +۲٬۰۰۰ تومان)","default":false},"gift_message_entities":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":50},{"type":"null"}],"title":"Gift Message Entities","description":"entities تلگرام برای پیام (مثلاً custom_emoji)"},"scheduled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled At","description":"زمان ارسال برنامه‌ریزی‌شده (ISO 8601)"},"pay_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pay Currency","description":"TON یا IRT؛ پیش‌فرض: منبع انتخاب‌شده در داشبورد"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"quote_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Quote Id"}},"type":"object","title":"OrderIn"},"PostInfoIn":{"properties":{"link":{"type":"string","maxLength":200,"title":"Link","description":"لینک پست: https://t.me/channel/123"},"fresh":{"type":"boolean","title":"Fresh","description":"true = کش ۱۰ دقیقه‌ای را نادیده بگیر","default":false}},"type":"object","required":["link"],"title":"PostInfoIn"},"QuoteIn":{"properties":{"type":{"type":"string","title":"Type","description":"stars | product | boost"},"quantity":{"type":"integer","maximum":1000000.0,"minimum":1.0,"title":"Quantity","default":1},"product_id":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Product Id"},"duration":{"anyOf":[{"type":"integer","maximum":400.0,"minimum":1.0},{"type":"null"}],"title":"Duration","description":"فقط برای boost: مدت به روز"},"recipient":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Recipient"}},"type":"object","required":["type"],"title":"QuoteIn"},"ReceiptIn":{"properties":{"received":{"type":"boolean","title":"Received","description":"true = آیتم را دریافت کردم (آزادسازی پول به فروشنده) | false = دریافت نکردم"}},"type":"object","required":["received"],"title":"ReceiptIn"},"ServiceOrderIn":{"properties":{"service":{"type":"string","maxLength":24,"title":"Service","description":"شناسه‌ی خدمت از GET /services"},"target":{"type":"string","maxLength":200,"title":"Target","description":"لینک پست، @کانال یا @ربات (بسته به input خدمت)"},"quantity":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":1.0},{"type":"null"}],"title":"Quantity","description":"برای custom_comments لازم نیست (= تعداد کامنت‌ها)"},"reaction":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Reaction","description":"فقط reactions: شناسه از /services/reactions"},"option":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Option","description":"سطح ضمانت یا تعداد پست از /services/{service}/options"},"comments":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":1000},{"type":"null"}],"title":"Comments","description":"فقط custom_comments: هر آیتم یک کامنت"},"drip_runs":{"type":"integer","maximum":20.0,"minimum":0.0,"title":"Drip Runs","description":"ارسال تدریجی: تعداد مرحله","default":0},"drip_interval":{"type":"integer","maximum":1440.0,"minimum":0.0,"title":"Drip Interval","description":"فاصله‌ی مرحله‌ها به دقیقه (۱۰ تا ۱۴۴۰)","default":0},"max_price":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Price","description":"اگر قیمت از این بیشتر شد سفارش با 409 price_changed رد شود"},"pay_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pay Currency","description":"TON یا IRT؛ پیش‌فرض: منبع داشبورد"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["service","target"],"title":"ServiceOrderIn"},"SimulateIn":{"properties":{"outcome":{"type":"string","title":"Outcome","description":"processing | completed | failed | refunded"}},"type":"object","required":["outcome"],"title":"SimulateIn"},"StarReactionOrderIn":{"properties":{"post_url":{"type":"string","maxLength":300,"title":"Post Url","description":"لینک پست: https://t.me/channel/123"},"stars":{"type":"integer","maximum":1000000.0,"minimum":1.0,"title":"Stars","description":"استارز برای هر پست"},"posts":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Posts","description":"همین پست + پست‌های بعدی کانال","default":1},"anonymous":{"type":"boolean","title":"Anonymous","description":"ری‌اکشن ناشناس","default":false},"scheduled_at":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Scheduled At","description":"زمان ارسال (ISO 8601)؛ خالی = فوری"},"pay_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pay Currency","description":"TON یا IRT"},"max_price":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Max Price"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["post_url","stars"],"title":"StarReactionOrderIn"},"TonSellIn":{"properties":{"destination":{"type":"string","pattern":"^(address|telegram_username)$","title":"Destination","description":"address: هر آدرس TON (ارسال خودکار) | telegram_username: کیف پول تلگرام یک یوزرنیم"},"amount_ton":{"type":"string","maxLength":24,"title":"Amount Ton","description":"مقداری که گیرنده دقیقاً می‌گیرد (حداقل 0.1 TON)"},"source":{"type":"string","pattern":"^(toman|ton)$","title":"Source","description":"از کدام کیف پول حساب کسر شود","default":"toman"},"address":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Address","description":"برای destination=address: آدرس TON مقصد (UQ…/EQ…/raw)"},"username":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Username","description":"برای destination=telegram_username: یوزرنیم گیرنده"},"max_pay":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Pay","description":"محافظ لغزش نرخ: حداکثر تومانی که حاضری کسر شود (فقط source=toman)"}},"type":"object","required":["destination","amount_ton"],"title":"TonSellIn"},"TopupIn":{"properties":{"amount_ton":{"anyOf":[{"type":"number","maximum":100000.0,"minimum":0.1},{"type":"null"}],"title":"Amount Ton"}},"type":"object","title":"TopupIn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WithdrawApiIn":{"properties":{"source":{"type":"string","pattern":"^(ton|toman)$","title":"Source"},"amount":{"type":"string","maxLength":32,"title":"Amount","description":"TON (برای source=ton) یا تومان (برای source=toman)"}},"type":"object","required":["source","amount"],"title":"WithdrawApiIn"}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"sk_live_… | sk_test_…"}}},"security":[{"bearerAuth":[]}],"externalDocs":{"url":"https://stard-market.ir/docs","description":"Stard developer docs"}}