> For the complete documentation index, see [llms.txt](https://developers.friendlypay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.friendlypay.io/common/poluchit-kurs.md).

# Получить курс

## Получение курса

> Возвращает курс.

```json
{"openapi":"3.0.3","info":{"title":"FriendlyPay API","version":"1.0.0"},"tags":[{"name":"Курс","description":"Получение курса обмена валют"}],"servers":[{"url":"https://pay.friendlypay.io","description":"Production API server (эндпоинты доступны по префиксу /api)"}],"security":[{"FpTimestamp":[],"FpNonce":[],"FpApiToken":[],"FpSignature":[]}],"components":{"securitySchemes":{"FpTimestamp":{"type":"apiKey","in":"header","name":"x-fp-timestamp","description":"Unix timestamp запроса (целое число, минимум 1)"}},"parameters":{"XFpTimestamp":{"name":"x-fp-timestamp","in":"header","required":true,"description":"Временная метка Unix.","schema":{"type":"integer","format":"int64","minimum":1}},"XFpNonce":{"name":"x-fp-nonce","in":"header","required":true,"description":"Уникальная строка.","schema":{"type":"string"}},"XFpApiToken":{"name":"x-fp-api-token","in":"header","required":true,"description":"Публичный api токен мерчанта.","schema":{"type":"string"}},"XFpSignature":{"name":"x-fp-signature","in":"header","required":true,"description":"HMAC-SHA256 подпись. Алгоритм формирования см. в разделе «Аутентификация».","schema":{"type":"string"}}},"schemas":{"RateDto":{"type":"object","description":"Курс обмена","required":["rate"],"properties":{"rate":{"type":"number","format":"decimal","description":"Курс","exclusiveMinimum":true,"minimum":0}}}},"responses":{"Unauthorized":{"description":"Ошибка авторизации — неверные или отсутствующие заголовки аутентификации"},"Forbidden":{"description":"Доступ запрещён — недостаточно прав для выполнения операции"},"InternalServerError":{"description":"Внутренняя ошибка сервера"}}},"paths":{"/api/v1/rates":{"get":{"tags":["Курс"],"summary":"Получение курса","description":"Возвращает курс.","operationId":"getRate","parameters":[{"$ref":"#/components/parameters/XFpTimestamp"},{"$ref":"#/components/parameters/XFpNonce"},{"$ref":"#/components/parameters/XFpApiToken"},{"$ref":"#/components/parameters/XFpSignature"},{"name":"orderCurrency","in":"query","required":true,"description":"Изначальная валюта","schema":{"type":"string"}},{"name":"paymentCurrency","in":"query","required":true,"description":"Конечная валюта","schema":{"type":"string"}}],"responses":{"200":{"description":"Курс успешно получен","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateDto"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```