# Kalshi मार्केट प्राप्त करें

**API:** Data API

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

**Tags:** Kalshi

दस्तावेज़ में बताए गए status, ticker, event, series और timestamp फ़िल्टर से prediction markets की सूची बनाएँ। कॉन्ट्रैक्ट में max_updated_ts है, लेकिन free-text search पैरामीटर घोषित नहीं है। market रिकॉर्ड और pagination के लिए response schema का पालन करें।

### मूल्य संदर्भ

- मीटरिंग: सफल request के निश्चित लागत आधार पर
- संदर्भ request अनुमान: 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 | pagination cursor। परिणामों का अगला पेज पाने के लिए पिछले response से लौटाया गया cursor मान उपयोग करें। पहले पेज के लिए खाली छोड़ें। |
| `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 सहायता से संपर्क करते समय शामिल करने के लिए request पहचानकर्ता।

**application/json**

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

### 400 — request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।

### 401 — एक वैध Felo API key आवश्यक है।

### 402 — request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।

### 403 — खाते को यह ऑपरेशन करने की अनुमति नहीं है।

### 429 — request या खर्च की सीमा तक पहुँच गए हैं।

### 502 — सेवा request पूरा नहीं कर सकी।

### 503 — API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।

### 504 — request संसाधित करते समय सेवा का समय समाप्त हो गया।

### default — त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।

**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\" कहलाती है)। request 0-2 दशमलव स्थान स्वीकार करते हैं (जैसे \"10\", \"10.0\", \"10.00\"); response हमेशा 2 दशमलव उत्सर्जित करते हैं। भिन्नात्मक कॉन्ट्रैक्ट मान (जैसे \"2.50\") समर्थित हैं; न्यूनतम ग्रैन्युलैरिटी 0.01 कॉन्ट्रैक्ट है।",
  "example": "10.00"
}
```

### Response24B585A0A861_FixedPointDollars

`#/components/schemas/Response24B585A0A861_FixedPointDollars`

```json
{
  "type": "string",
  "description": "फ़िक्स्ड-पॉइंट US डॉलर स्ट्रिंग। अधिकांश request फ़ील्ड 2-4 दशमलव स्थान स्वीकार करते हैं (जैसे \"0.56\", \"0.5600\"); response अधिकतम 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": "इस रेंज के लिए कीमत का स्टेप/टिक आकार डॉलर में"
    }
  }
}
```
