# Get Instruments in Graphql

This query returns a list of instruments with basic fields and instrument type.

---

[![Screenshot 2025-12-16 at 17.42.03.png](https://docs.finmars.com/uploads/images/gallery/2025-12/scaled-1680-/screenshot-2025-12-16-at-17-42-03.png)](https://docs.finmars.com/uploads/images/gallery/2025-12/screenshot-2025-12-16-at-17-42-03.png)

### GraphQL Query

```graphql
query GetInstrumentList {
  instrument(
    pagination: {
      limit: 20
      offset: 0
    }
  ) {
    id
    user_code
    name
    maturity_date
    instrument_type {
      id
      user_code
      name
    }
  }
}
```

---

### Python Example

```python
import requests

url = "https://<domain_name>/<realm_code>/<space_code>/graphql/"

headers = {
    "Authorization": "Bearer <access_token>",
    "Content-Type": "application/json"
}

payload = {
    "query": """
    query GetInstrumentList {
      instrument(
        pagination: {
          limit: 20
          offset: 0
        }
      ) {
        id
        user_code
        name
        maturity_date
        instrument_type {
          id
          user_code
          name
        }
      }
    }
    """
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
```

---

### Notes

- Field names must match the schema (`<span class="editor-theme-code">maturity_date</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">instrument_type</span>`, etc.)
- <span style="white-space: pre-wrap;">Add filters the same way as in </span>`<span class="editor-theme-code">currency_history</span>`<span style="white-space: pre-wrap;"> when needed (Previous documentation page)</span>