# Query Currency

### API Overview

This API retrieves the list of supported currencies in the system, with options for pagination and keyword-based fuzzy search.

* **Request Method：**`GET`
* **Request URL：**`https://openapi.elven.com/open/v3/currency`

### Request Headers

<table><thead><tr><th width="202">Parameter Name</th><th width="90">Type</th><th width="100">Required</th><th>Description</th></tr></thead><tbody><tr><td>elven-api-key</td><td>String</td><td>Yes</td><td>The API key assigned to you</td></tr><tr><td>elven-api-sign</td><td>String</td><td>Yes</td><td>Request signature, used to verify the legitimacy of the request</td></tr><tr><td>elven-api-timestamp</td><td>String</td><td>Yes</td><td>Request timestamp, in milliseconds</td></tr></tbody></table>

[View Details](https://docs.elven.com/v3/~/changes/YkdBoYHdjwadymwIANKf/openapi/obtaining-api-authorization?r=LJbAoiJKFX1i7Py2GCYr)

### Request Parameters

#### Query 参数

<table><thead><tr><th width="202">Parameter Name</th><th width="94">Type</th><th width="106">Required</th><th>Description</th></tr></thead><tbody><tr><td>page</td><td>Number</td><td>No</td><td>The page number to retrieve. Defaults to 1 if not provided.</td></tr><tr><td>limit</td><td>Number</td><td>No</td><td>The number of records per page. Defaults to 10 if not provided.</td></tr><tr><td>keyword</td><td>String</td><td>No</td><td>A keyword for fuzzy search. If omitted, no filtering is applied.</td></tr></tbody></table>

#### Example Request

```bash
GET https://openapi.elven.com/open/v3/currency?page=1&limit=10&keyword=b
```

### Response Parameters

<table><thead><tr><th width="209">Parameter Name</th><th width="94">Type</th><th>Description</th></tr></thead><tbody><tr><td>total</td><td>Number</td><td>The total number of currencies matching the query.</td></tr><tr><td>list</td><td>Array</td><td>A list of currencies</td></tr></tbody></table>

#### list of objects

<table><thead><tr><th width="210">Parameter Name</th><th width="91">Type</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>String</td><td>The name of the currency</td></tr><tr><td>currency</td><td>String</td><td>The currency code (e.g., <code>BTC</code>, <code>USD</code>).</td></tr><tr><td>type</td><td>String</td><td>The type of currency (<code>CRYPTO</code> for cryptocurrencies, <code>FIAT</code> for fiat currencies).</td></tr></tbody></table>

#### Example Response

```json
{
    "total": 100,
    "list": [
        {
            "name": "Bitcoin",
            "currency": "BTC",
            "type": "CRYPTO"
        },
        {
            "name": "United States Dollar",
            "currency": "USD",
            "type": "FIAT"
        }
    ]
}
```

### **Notes**

* The following headers are required for all requests to ensure security and validity: elven-api-key,elven-api-sign,elven-api-timestamp
* If page and limit are not provided, the API defaults to returning the first page with 10 records per page. If keyword is not provided, no keyword filtering is applied.