# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.elven.com/v3/openapi/query-currency.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.