# Kalshi মার্কেট নিন

**API:** Data API

**Endpoint:** `GET /v1/beta/kalshi/markets`

**Tags:** Kalshi

ডকুমেন্টে উল্লেখিত status, ticker, event, series ও timestamp ফিল্টার দিয়ে prediction market তালিকা করুন। কন্ট্রাক্টে max_updated_ts আছে, কিন্তু free-text search প্যারামিটার ঘোষণা করা নেই। market রেকর্ড ও pagination-এর জন্য রেসপন্স স্কিমা অনুসরণ করুন।

### মূল্য রেফারেন্স

- মিটারিং: সফল রিকোয়েস্টের নির্দিষ্ট খরচের ভিত্তিতে
- রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.02

এটি কেবল রেফারেন্স মেটাডেটা; অ্যাকাউন্টের কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo-এর বিলিং রেকর্ড অনুযায়ী হয়।

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | no | string | পেজিনেশন কার্সর। ফলাফলের পরের পেজ পেতে পূর্ববর্তী রেসপন্সে ফেরত দেওয়া কার্সর মান ব্যবহার করুন। প্রথম পেজের জন্য খালি রাখুন। |
| `event_ticker` | query | no | string | ফিল্টার করার জন্য ইভেন্ট টিকার। শুধু একটি ইভেন্ট টিকার সমর্থিত। |
| `limit` | query | no | integer, (int64), default: 100 | প্রতি পেজে ফলাফলের সংখ্যা। ডিফল্ট 100। সর্বোচ্চ মান 1000। |
| `max_close_ts` | query | no | integer, (int64) | এই Unix টাইমস্ট্যাম্পের আগে বন্ধ হওয়া আইটেম ফিল্টার করুন |
| `max_created_ts` | query | no | integer, (int64) | এই Unix টাইমস্ট্যাম্পের আগে তৈরি হওয়া আইটেম ফিল্টার করুন |
| `max_settled_ts` | query | no | integer, (int64) | এই Unix টাইমস্ট্যাম্পের আগে নিষ্পত্তি হওয়া আইটেম ফিল্টার করুন |
| `max_updated_ts` | query | no | integer, (int64) | এই Unix টাইমস্ট্যাম্পে (সেকেন্ডে) বা তার আগে মেটাডেটা আপডেট হওয়া মার্কেট ফেরত দিন। শুধু নন-ট্রেডিং পরিবর্তন ট্র্যাক করে। min_updated_ts ও mve_filter=exclude-এর সঙ্গে মিলিয়ে ব্যবহার করা যায়। series_ticker-এর সঙ্গেও মিলিয়ে ব্যবহার করা যায়, যার জন্য mve_filter=exclude আবশ্যক। অন্য ফিল্টারের সঙ্গে বেমানান। |
| `min_close_ts` | query | no | integer, (int64) | এই Unix টাইমস্ট্যাম্পের পরে বন্ধ হওয়া আইটেম ফিল্টার করুন |
| `min_created_ts` | query | no | integer, (int64) | এই Unix টাইমস্ট্যাম্পের পরে তৈরি হওয়া আইটেম ফিল্টার করুন |
| `min_settled_ts` | query | no | integer, (int64) | এই Unix টাইমস্ট্যাম্পের পরে নিষ্পত্তি হওয়া আইটেম ফিল্টার করুন |
| `min_updated_ts` | query | no | integer, (int64) | এই Unix টাইমস্ট্যাম্পের (সেকেন্ডে) পরে মেটাডেটা আপডেট হওয়া মার্কেট ফেরত দিন। শুধু নন-ট্রেডিং পরিবর্তন ট্র্যাক করে। max_updated_ts ও mve_filter=exclude-এর সঙ্গে মিলিয়ে ব্যবহার করা যায়। series_ticker-এর সঙ্গেও মিলিয়ে ব্যবহার করা যায়, যার জন্য mve_filter=exclude আবশ্যক। অন্য ফিল্টারের সঙ্গে বেমানান। |
| `mve_filter` | query | no | string, enum: "only", "exclude" | মাল্টিভারিয়েট ইভেন্ট (combo) দিয়ে ফিল্টার করুন। 'only' শুধু মাল্টিভারিয়েট ইভেন্ট ফেরত দেয়, 'exclude' মাল্টিভারিয়েট ইভেন্ট বাদ দেয়। |
| `series_ticker` | query | no | string | সিরিজ টিকার দিয়ে ফিল্টার করুন |
| `status` | query | no | string, enum: "unopened", "open", "paused", "closed", "settled" | মার্কেট স্ট্যাটাস দিয়ে ফিল্টার করুন। যেকোনো স্ট্যাটাসের মার্কেট ফেরত পেতে খালি রাখুন। |
| `tickers` | query | no | string | নির্দিষ্ট মার্কেট টিকার দিয়ে ফিল্টার করুন। আনার জন্য মার্কেট টিকারের কমা-বিভক্ত তালিকা। |

## Responses

### 200 — মার্কেট সফলভাবে পাওয়া গেছে

Headers:
- `X-Request-Id` (string) — Felo সাপোর্টে যোগাযোগের সময় অন্তর্ভুক্ত করার জন্য রিকোয়েস্ট আইডেন্টিফায়ার।

**application/json**

Schema: `Response24B585A0A861_GetMarketsResponse` (`#/components/schemas/Response24B585A0A861_GetMarketsResponse`)

### 400 — রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।

### 401 — একটি বৈধ Felo API key আবশ্যক।

### 402 — বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।

### 403 — অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।

### 429 — রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।

### 502 — পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।

### 503 — API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।

### 504 — রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।

### default — ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response24B585A0A861_ExchangeIndex

`#/components/schemas/Response24B585A0A861_ExchangeIndex`

```json
{
  "type": "integer",
  "description": "এক্সচেঞ্জ shard-এর আইডেন্টিফায়ার।",
  "example": 0
}
```

### Response24B585A0A861_FixedPointCount

`#/components/schemas/Response24B585A0A861_FixedPointCount`

```json
{
  "type": "string",
  "description": "ফিক্সড-পয়েন্ট কন্ট্র্যাক্ট সংখ্যার স্ট্রিং (2 দশমিক, যেমন \"10.00\"; ফিল্ড নামে \"fp\" নামে পরিচিত)। রিকোয়েস্ট 0-2 দশমিক স্থান গ্রহণ করে (যেমন \"10\", \"10.0\", \"10.00\"); রেসপন্স সবসময় 2 দশমিক দেয়। ভগ্নাংশ কন্ট্র্যাক্ট মান (যেমন \"2.50\") সমর্থিত; সর্বনিম্ন গ্র্যানুলারিটি 0.01 কন্ট্র্যাক্ট।",
  "example": "10.00"
}
```

### Response24B585A0A861_FixedPointDollars

`#/components/schemas/Response24B585A0A861_FixedPointDollars`

```json
{
  "type": "string",
  "description": "ফিক্সড-পয়েন্ট মার্কিন ডলার স্ট্রিং। বেশিরভাগ রিকোয়েস্ট ফিল্ড 2-4 দশমিক স্থান গ্রহণ করে (যেমন \"0.56\", \"0.5600\"); রেসপন্স সর্বোচ্চ 6 পর্যন্ত দেয়। একটি মার্কেটের বৈধ কোট ইন্টারভাল সেই মার্কেটের প্রাইস লেভেল স্ট্রাকচার দ্বারা সীমাবদ্ধ।",
  "example": "0.5600"
}
```

### Response24B585A0A861_GetMarketsResponse

`#/components/schemas/Response24B585A0A861_GetMarketsResponse`

```json
{
  "type": "object",
  "required": [
    "markets",
    "cursor"
  ],
  "properties": {
    "markets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_Market"
      }
    },
    "cursor": {
      "type": "string"
    }
  }
}
```

### Response24B585A0A861_Market

`#/components/schemas/Response24B585A0A861_Market`

```json
{
  "type": "object",
  "required": [
    "ticker",
    "event_ticker",
    "market_type",
    "yes_sub_title",
    "no_sub_title",
    "created_time",
    "updated_time",
    "open_time",
    "close_time",
    "latest_expiration_time",
    "settlement_timer_seconds",
    "status",
    "notional_value_dollars",
    "yes_bid_dollars",
    "yes_ask_dollars",
    "no_bid_dollars",
    "no_ask_dollars",
    "yes_bid_size_fp",
    "yes_ask_size_fp",
    "last_price_dollars",
    "previous_yes_bid_dollars",
    "previous_yes_ask_dollars",
    "previous_price_dollars",
    "volume_fp",
    "volume_24h_fp",
    "open_interest_fp",
    "result",
    "can_close_early",
    "expiration_value",
    "rules_primary",
    "rules_secondary",
    "price_level_structure",
    "price_ranges",
    "settlement_bounds_type"
  ],
  "properties": {
    "ticker": {
      "type": "string"
    },
    "event_ticker": {
      "type": "string"
    },
    "market_type": {
      "type": "string",
      "enum": [
        "binary",
        "scalar"
      ],
      "description": "মার্কেটের ধরন শনাক্ত করে"
    },
    "title": {
      "type": "string",
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true
    },
    "subtitle": {
      "type": "string",
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true
    },
    "yes_sub_title": {
      "type": "string",
      "description": "এই মার্কেটের yes দিকের সংক্ষিপ্ত শিরোনাম"
    },
    "no_sub_title": {
      "type": "string",
      "description": "এই মার্কেটের no পক্ষের সংক্ষিপ্ত শিরোনাম"
    },
    "created_time": {
      "type": "string",
      "format": "date-time"
    },
    "updated_time": {
      "type": "string",
      "format": "date-time",
      "description": "সর্বশেষ নন-ট্রেডিং মেটাডেটা আপডেটের সময়।"
    },
    "open_time": {
      "type": "string",
      "format": "date-time"
    },
    "close_time": {
      "type": "string",
      "format": "date-time"
    },
    "expected_expiration_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "যে সময়ে এই মার্কেটের মেয়াদ শেষ হওয়ার প্রত্যাশা"
    },
    "expiration_time": {
      "type": "string",
      "format": "date-time",
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true
    },
    "latest_expiration_time": {
      "type": "string",
      "format": "date-time",
      "description": "এই মার্কেটের মেয়াদ শেষ হওয়ার সর্বশেষ সম্ভাব্য সময়"
    },
    "settlement_timer_seconds": {
      "type": "integer",
      "description": "নির্ধারণের পর মার্কেট সেটেল হতে যে সময় লাগে"
    },
    "status": {
      "type": "string",
      "enum": [
        "initialized",
        "inactive",
        "active",
        "closed",
        "determined",
        "disputed",
        "amended",
        "finalized"
      ],
      "description": "এর লাইফসাইকেলে মার্কেটের বর্তমান অবস্থা।"
    },
    "yes_bid_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "yes_bid_size_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "yes_ask_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "yes_ask_size_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "no_bid_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "no_ask_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "last_price_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "volume_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "volume_24h_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "result": {
      "type": "string",
      "enum": [
        "yes",
        "no",
        "scalar",
        ""
      ]
    },
    "can_close_early": {
      "type": "boolean"
    },
    "open_interest_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "notional_value_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "previous_yes_bid_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "previous_yes_ask_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "previous_price_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "settlement_value_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "settlement_ts": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "মার্কেট সেটেল হওয়ার টাইমস্ট্যাম্প। কেবল সেটেল হওয়া মার্কেটের জন্য পূরণ করা হয়"
    },
    "settlement_bounds_type": {
      "type": "string",
      "enum": [
        "default",
        "floor"
      ],
      "description": "এই মার্কেটে কোন নিষ্পত্তি সীমা প্রযোজ্য। default মানে মার্কেটের কোনো নিষ্পত্তি সীমা নেই"
    },
    "settlement_floor_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "expiration_value": {
      "type": "string",
      "description": "যে মানটি নিষ্পত্তির জন্য বিবেচনা করা হয়েছিল"
    },
    "occurrence_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "অন্তর্নিহিত ইভেন্ট ঘটার রেকর্ড করা datetime, যদি উপলব্ধ থাকে"
    },
    "fee_waiver_expiration_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "যে সময়ে এই মার্কেটের ফি মওকুফের মেয়াদ শেষ হয়"
    },
    "early_close_condition": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "যে শর্তে মার্কেট আগেই বন্ধ হতে পারে",
      "x-go-type-skip-optional-pointer": true
    },
    "strike_type": {
      "type": "string",
      "enum": [
        "greater",
        "greater_or_equal",
        "less",
        "less_or_equal",
        "between",
        "functional",
        "custom",
        "structured"
      ],
      "x-omitempty": true,
      "description": "স্ট্রাইক টাইপ নির্ধারণ করে মার্কেট স্ট্রাইক কীভাবে সংজ্ঞায়িত ও মূল্যায়ন করা হয়",
      "x-go-type-skip-optional-pointer": true
    },
    "floor_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "সর্বনিম্ন expiration মান যা YES নিষ্পত্তির দিকে নিয়ে যায়"
    },
    "cap_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "সর্বোচ্চ expiration মান যা YES নিষ্পত্তির দিকে নিয়ে যায়"
    },
    "functional_strike": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "expiration মান থেকে নিষ্পত্তি মানের ম্যাপিং"
    },
    "custom_strike": {
      "type": [
        "object",
        "null"
      ],
      "x-omitempty": true,
      "description": "প্রতিটি target-এর জন্য expiration মান যা YES নিষ্পত্তির দিকে নিয়ে যায়"
    },
    "rules_primary": {
      "type": "string",
      "description": "সবচেয়ে গুরুত্বপূর্ণ মার্কেট শর্তের সাধারণ ভাষায় বিবরণ"
    },
    "rules_secondary": {
      "type": "string",
      "description": "সেকেন্ডারি মার্কেট শর্তের সাধারণ ভাষায় বিবরণ"
    },
    "mve_collection_ticker": {
      "type": "string",
      "x-omitempty": true,
      "description": "মাল্টিভারিয়েট ইভেন্ট সংগ্রহের টিকার",
      "x-go-type-skip-optional-pointer": true
    },
    "mve_selected_legs": {
      "type": "array",
      "x-omitempty": true,
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_MveSelectedLeg"
      },
      "x-go-type-skip-optional-pointer": true
    },
    "primary_participant_key": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true
    },
    "price_level_structure": {
      "type": "string",
      "description": "এই মার্কেটের জন্য প্রাইস লেভেল স্ট্রাকচার, যা প্রাইস রেঞ্জ ও tick সাইজ নির্ধারণ করে"
    },
    "price_ranges": {
      "type": "array",
      "description": "এই মার্কেটে অর্ডারের জন্য বৈধ প্রাইস রেঞ্জ",
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_PriceRange"
      }
    },
    "is_provisional": {
      "type": "boolean",
      "x-omitempty": true,
      "description": "true হলে, নির্ধারণের পর মার্কেটে কোনো কার্যকলাপ না থাকলে সেটি সরিয়ে ফেলা হতে পারে",
      "x-go-type-skip-optional-pointer": true
    },
    "exchange_index": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Response24B585A0A861_ExchangeIndex"
        }
      ],
      "x-go-type-skip-optional-pointer": true,
      "x-omitempty": false
    }
  }
}
```

### Response24B585A0A861_MveSelectedLeg

`#/components/schemas/Response24B585A0A861_MveSelectedLeg`

```json
{
  "type": "object",
  "properties": {
    "event_ticker": {
      "type": "string",
      "description": "নির্বাচিত ইভেন্টের অনন্য আইডেন্টিফায়ার",
      "x-go-type-skip-optional-pointer": true
    },
    "market_ticker": {
      "type": "string",
      "description": "নির্বাচিত মার্কেটের অনন্য আইডেন্টিফায়ার",
      "x-go-type-skip-optional-pointer": true
    },
    "side": {
      "type": "string",
      "description": "নির্বাচিত মার্কেটের দিক",
      "x-go-type-skip-optional-pointer": true
    },
    "yes_settlement_value_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    }
  }
}
```

### Response24B585A0A861_PriceRange

`#/components/schemas/Response24B585A0A861_PriceRange`

```json
{
  "type": "object",
  "required": [
    "start",
    "end",
    "step"
  ],
  "properties": {
    "start": {
      "type": "string",
      "description": "এই রেঞ্জের শুরুর মূল্য ডলারে"
    },
    "end": {
      "type": "string",
      "description": "এই রেঞ্জের শেষ মূল্য ডলারে"
    },
    "step": {
      "type": "string",
      "description": "এই রেঞ্জের জন্য মূল্যের স্টেপ/টিক সাইজ ডলারে"
    }
  }
}
```
