> For the complete documentation index, see [llms.txt](https://docs.odds88.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.odds88.io/odds88-client-api/odds88-api-endpoints/currency-exchange-api.md).

# Currency Exchange API

Currency Exchange API provides information about supported currencies and their precision to be used in Bet Placement and cashout process.

{% content-ref url="/pages/2l7cTFxJAk5U4UAqv2Er" %}
[Bets API](/odds88-client-api/odds88-api-endpoints/bets-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/CDyqERePHyDhrua9zyke" %}
[Cashout API](/odds88-client-api/odds88-api-endpoints/cashout-api.md)
{% endcontent-ref %}

{% hint style="info" %}
The exact exchange rate is not provided.
{% endhint %}

## Active Currencies Endpoint

Gets the list of supported currencies by type.

{% hint style="warning" %}
The endpoint is rate-limited to **10 requests per 1 minute**.
{% endhint %}

## Gets active currencies for the given currency type

> \
> \*\*Rate Limits (per account):\*\*\
> \- \*\*10 req/1m\*\*

```json
{"openapi":"3.0.4","info":{"title":"[T728-STAGE] Odds88 API","version":"v1"},"tags":[{"name":"CurrencyExchange"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\"","scheme":"Bearer","bearerFormat":"JWT"}},"schemas":{"CurrencyExchange.Models.CurrencyType":{"enum":[1,2,3],"type":"integer","description":"* `1` - Fiat\n* `2` - Crypto\n* `3` - Custom","format":"int32"},"CurrencyExchange.Models.Currencies.OutboundDTO.ActiveCurrencyDto":{"type":"object","properties":{"symbol":{"type":"string","nullable":true},"type":{"allOf":[{"$ref":"#/components/schemas/CurrencyExchange.Models.CurrencyType"}],"description":"* `1` - Fiat\n* `2` - Crypto\n* `3` - Custom"},"precision":{"type":"integer","format":"int32"}},"additionalProperties":false}}},"paths":{"/api/CurrencyExchange/active-currencies":{"get":{"tags":["CurrencyExchange"],"summary":"Gets active currencies for the given currency type","description":"\n**Rate Limits (per account):**\n- **10 req/1m**","operationId":"Get active currencies","parameters":[{"name":"type","in":"query","description":"Currency type to filter (if null - returns all active currencies for all types)","schema":{"allOf":[{"$ref":"#/components/schemas/CurrencyExchange.Models.CurrencyType"}],"description":"* `1` - Fiat\n* `2` - Crypto\n* `3` - Custom"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.ActiveCurrencyDto"}}},"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.ActiveCurrencyDto"}}},"text/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.ActiveCurrencyDto"}}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"429":{"description":"Too many requests"},"500":{"description":"Internal Server Error"}}}}}}
```

## Currency Precision Endpoint

Gets precision value of the specified currency.

{% hint style="warning" %}
The endpoint is rate-limited to **1 request per 1 second**.
{% endhint %}

## Gets precision value for the given currency ticker symbol

> \
> \*\*Rate Limits (per account):\*\*\
> \- \*\*1 req/1s\*\*

```json
{"openapi":"3.0.4","info":{"title":"[T728-STAGE] Odds88 API","version":"v1"},"tags":[{"name":"CurrencyExchange"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\"","scheme":"Bearer","bearerFormat":"JWT"}},"schemas":{"CurrencyExchange.Models.Currencies.OutboundDTO.CurrencyPrecisionDto":{"type":"object","properties":{"precision":{"type":"integer","format":"int32"}},"additionalProperties":false}}},"paths":{"/api/CurrencyExchange/currency-precision":{"get":{"tags":["CurrencyExchange"],"summary":"Gets precision value for the given currency ticker symbol","description":"\n**Rate Limits (per account):**\n- **1 req/1s**","operationId":"Get precision of a currency","parameters":[{"name":"symbol","in":"query","description":"Currency ticker symbol","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.CurrencyPrecisionDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.CurrencyPrecisionDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/CurrencyExchange.Models.Currencies.OutboundDTO.CurrencyPrecisionDto"}}}},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"429":{"description":"Too many requests"},"500":{"description":"Internal Server Error"}}}}}}
```