# API Documentation

**Api url:** <https://quoter.coinquoter.com>

## Endpoints

### Blockchains

Returns an array of all active blockchains.

`GET /getBlockChains`

**Parameters**

There are no parameters for this endpoint.

**Response**

```
[
    {
        "name": "Harmony Mainnet",
        "chain_id": "1666600000",
        "rpc_url": "https://iad.api.harmony.one/",
        "currency_symbol": "ONE",
        "block_explorer_url": "https://explorer.harmony.one/tx/0x",
        "blockchain_icon_url": "https://harmony.one/logo",
        "currency_name": "One"
    },
    {
        "name": "Ethereum Mainnet",
        "chain_id": "1",
        "rpc_url": "https://mainnet.infura.io/v3/9aa3d95b3bc440fa88ea12eaa4456161",
        "currency_symbol": "ETH",
        "block_explorer_url": "https://etherscan.io/tx/0x",
        "blockchain_icon_url": "https://ethereum.org/static/a183661dd70e0e5c70689a0ec95ef0ba/81d9f/eth-diamond-purple.webp",
        "currency_name": "Ether"
    },
    {
        "name": "Binance Smart Chain Testnet",
        "chain_id": "97",
        "rpc_url": "https://data-seed-prebsc-1-s1.binance.org:8545/",
        "currency_symbol": "BNB",
        "block_explorer_url": "https://testnet.bscscan.com/tx/0x",
        "blockchain_icon_url": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png",
        "currency_name": "BNB"
    }
]
```

### LLDEX Address

Returns lldex contract address on a given blockchain.

`GET /getLLDEXAddress`

**Parameters**

<table><thead><tr><th width="171.7142857142857">Name</th><th width="150">Type</th><th width="150">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>chainId</td><td>Number</td><td>Yes</td><td>Id of a blockchain.</td></tr></tbody></table>

**Response**

```
{
    "address": "0xC9BdEC6F2C54d3577f5ccAD29a7f0fE9778b4d9f"
}
```

### **Native Token**

Returns native currency of blockchain.

`GET /getNativeToken`

**Parameters**

<table><thead><tr><th width="171.7142857142857">Name</th><th width="150">Type</th><th width="150">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>chainId</td><td>Number</td><td>Yes</td><td>Id of a blockchain.</td></tr></tbody></table>

**Response**

```
{
    "address": "0xca3e951D17C520B42ED98482b1f8B6478D4531E2",
    "decimals": 18,
    "name": "Wrapped ONE",
    "symbol": "WONE"
}
```

### Transaction History

Endpoint returns an array of transaction logs for a specific wallet address. Each log provides extensive information on the transaction, as well as market snapshots 30 seconds before and after the transaction.

`GET /getTransactionHistory`

**Parameters**

<table><thead><tr><th width="150">Name</th><th width="150">Type</th><th width="150">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>takerAddress</td><td>String</td><td>Yes</td><td>Address of taker wallet.</td></tr></tbody></table>

**Response**

```
[
    {
        "side": "Buy",
        "amount_token0": "0.010000000000000",
        "amount_token1": "0.075227386195448",
        "price": "0.125200060000000",
        "creation_date": "2022-04-21T09:04:47.892Z",
        "last_changed": "2022-04-21T09:05:26.703Z",
        "tx_hash": "499e6a5c76920118987055b19b5d8d0217e4c9559e8023d61e284bb606b2677d",
        "status": 6,
        "data": [
            {
                "order": {
                    "type": 1,
                    "ruleId": 114,
                    "orderGas": {
                        "gasFee": 0.00464478,
                        "gasFeeToken0": "0.00464478",
                        "gasFeeToken1": "0.0005812709931000001",
                        "gasFeeOperation": 4
                    },
                    "limitOrder": {
                        "info": "30446972509125225999076426680",
                        "feeAmount": "0",
                        "makerAsset": "0xca3e951D17C520B42ED98482b1f8B6478D4531E2",
                        "takerAsset": "0xb63b211f1dB545C04829CA0a3E7D8313711E7eA9",
                        "makerAssetData": "0x23b872dd00000000000000000000000098c3cec32166936672a75fd7d85ad92eb5178d84000000000000000000000000da0dd31b18c6babc35e7d59f94fae7a180594c7b000000000000000000000000000000000000000000000000010b42e8bf8f8ed6",
                        "takerAssetData": "0x23b872dd000000000000000000000000da0dd31b18c6babc35e7d59f94fae7a180594c7b00000000000000000000000098c3cec32166936672a75fd7d85ad92eb5178d840000000000000000000000000000000000000000000000000000000000002710",
                        "feeTokenAddress": "0x65e3E8A0218F56858DDD669eF2B2e42f928749cD",
                        "frontendAddress": "0xDa0DD31b18C6BABc35e7d59f94fAe7a180594C7b"
                    },
                    "sessionKey": "0xD9594fa3BAd626Eed13d0F2b5BFDC2dd7a7576e9",
                    "makerAmount": "75227386195447510",
                    "takerAmount": "10000",
                    "limitOrderSignature": "0xfd3af2fd42a9c7129652cbde6b06ff9f2c17afcdb4f8f201b235809ac4f06d886ccf8a9d7bbe44541c1252f14f48db13d31858b6ca8c225d7f21e8a96a8ae03e1b"
                },
                "reason": "Order request is valid",
                "status": "pending",
                "timestamp": "2022-04-21T09:04:47.688Z",
                "pricing_rule": {
                    "id": 114,
                    "side": 1,
                    "depth": 5,
                    "hedge": 0,
                    "active": 1,
                    "comment": null,
                    "pair_id": 1,
                    "min_amount": 0.000001,
                    "spread_perc": 0.0004,
                    "stream_name": "oneusdt",
                    "stream_size": 100,
                    "pricingSource": "BINANCE",
                    "pricing_data_id": 1,
                    "active_rule_based": 1,
                    "max_slippage_perc": 5
                },
                "activation_rules": []   // Array of activation rules. empty if pricing rule didn't have any rules
            },
            {
                "amount": 0.07522738619544751,
                "reason": "Awaiting execution",
                "status": "lock_pending_trade",
                "timestamp": "2022-04-21T09:04:47.689Z"
            },
            {
                "status": "send_to_blockchain",
                "timestamp": "2022-04-21T09:04:53.336Z"
            },
            {
                "status": "filled",
                "timestamp": "2022-04-21T09:04:56.691Z"
            },
            {
                "amount": 0.07522738619544751,
                "reason": "Execution finished",
                "status": "unlock_pending_trade",
                "timestamp": "2022-04-21T09:04:56.697Z"
            },
            {
                "status": "market_snapshot",
                "history": [
                    {
                        "ask": 0.125240076,
                        "bid": 0.125144966,
                        "timestamp": "2022-04-21 09:05:26.692"
                    },
                    {
                        "ask": 0.125240076,
                        "bid": 0.125144966,
                        "timestamp": "2022-04-21 09:05:26.428"
                    },
                    ...   // market snapshot 30sec before and after transaction
                ], 
                "timestamp": "2022-04-21T09:05:26.703Z"
            }
        ],
        "taker_address": "0xDa0DD31b18C6BABc35e7d59f94fAe7a180594C7b",
        "maker_address": "0x98C3CEC32166936672A75FD7D85ad92eb5178D84",
        "pair_id": 1,
        "token0_symbol": "WONE",
        "token1_symbol": "1USDT",
        "block_explorer_url": "https://explorer.harmony.one/tx/0x",
        "gas_fee": "0.00464478",
        "fee_amount": "0.000000000000000000000000000000",
        "frontend_address": "0xDa0DD31b18C6BABc35e7d59f94fAe7a180594C7b",
        "tokenssymbol": "WONE/1USDT"
    }
]          
```

### Active **T**oken Pairs

Returns an array of active token pairs on a given blockchain.

`GET /getActiveTokenPairs`

**Parameters**

<table><thead><tr><th width="171.7142857142857">Name</th><th width="150">Type</th><th width="150">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>chainId</td><td>Number</td><td>Yes</td><td>Id of a blockchain.</td></tr></tbody></table>

**Response**

```
[
    {
        "pairid": 2,
        "tokensymbol0": "WONE",
        "tokensymbol1": "1WBTC"
    },
    {
        "pairid": 3,
        "tokensymbol0": "1ETH",
        "tokensymbol1": "1WBTC"
    },
    {
        "pairid": 1,
        "tokensymbol0": "WONE",
        "tokensymbol1": "1USDT"
    }
]
```

### Maker Active Token Pairs

Returns an array of active token pairs for a specific maker address on a given blockchain.

`GET /getMakerActiveTokenPairs`

**Parameters**

<table><thead><tr><th width="171.7142857142857">Name</th><th width="150">Type</th><th width="150">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><code>chainId</code></mark></td><td>Number</td><td>Yes</td><td>Id of a blockchain.</td></tr><tr><td>makerAddress</td><td>String</td><td>Yes</td><td>Address of maker wallet address.</td></tr></tbody></table>

**Response**

```
[
    {
        "pairid": 2,
        "tokensymbol0": "WONE",
        "tokensymbol1": "1WBTC"
    },
    {
        "pairid": 1,
        "tokensymbol0": "WONE",
        "tokensymbol1": "1USDT"
    }
]
```

### Get Max Slippage

Return max slippage value for a specific maker on a given blockchain.

`POST /maker/getMaxSlippage`

**Parameters**

<table><thead><tr><th width="171.7142857142857">Name</th><th width="150">Type</th><th width="150">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>typedData</td><td>EIP712TypedData</td><td>Yes</td><td>Object created with "buildRFQOrderTypedData" method from limit order protocol library.</td></tr><tr><td>signature</td><td>String</td><td>Yes</td><td>String created with "buildOrderSignature" method from limit order protocol library.</td></tr><tr><td>publicKey</td><td>String</td><td>Yes</td><td>Session public key.</td></tr><tr><td>makerAddress</td><td>String</td><td>Yes</td><td>Address of maker wallet address.</td></tr><tr><td>chainId</td><td>Number</td><td>Yes</td><td>Id of a blockchain.</td></tr></tbody></table>

**Response**

```
{
    "result": "250"
}
```

### Set Max Slippage

Set max slippage value for a specific maker on a given blockchain.

`POST /maker/setMaxSlippage`

**Parameters**

<table><thead><tr><th width="171.7142857142857">Name</th><th width="150">Type</th><th width="150">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>typedData</td><td>EIP712TypedData</td><td>Yes</td><td>Object created with "buildRFQOrderTypedData" method from limit order protocol library.</td></tr><tr><td>signature</td><td>String</td><td>Yes</td><td>String created with "buildOrderSignature" method from limit order protocol library.</td></tr><tr><td>publicKey</td><td>String</td><td>Yes</td><td>Session public key.</td></tr><tr><td>makerAddress</td><td>String</td><td>Yes</td><td>Address of maker wallet address.</td></tr><tr><td>chainId</td><td>Number</td><td>Yes</td><td>Id of a blockchain.</td></tr><tr><td>slippage</td><td>Number</td><td>Yes</td><td>The slippage value you want to set.</td></tr></tbody></table>

**Response**

```
{
    "result": "Max slippage set successfully"
}
```

### Get Max **Gas Fee**

Return max gas fee value for a specific maker on a given blockchain.

`POST /maker/getMaxGasFee`

**Parameters**

<table><thead><tr><th width="171.7142857142857">Name</th><th width="150">Type</th><th width="150">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>typedData</td><td>EIP712TypedData</td><td>Yes</td><td>Object created with "buildRFQOrderTypedData" method from limit order protocol library.</td></tr><tr><td>signature</td><td>String</td><td>Yes</td><td>String created with "buildOrderSignature" method from limit order protocol library.</td></tr><tr><td>publicKey</td><td>String</td><td>Yes</td><td>Session public key.</td></tr><tr><td>makerAddress</td><td>String</td><td>Yes</td><td>Address of maker wallet address.</td></tr><tr><td>chainId</td><td>Number</td><td>Yes</td><td>Id of a blockchain.</td></tr></tbody></table>

**Response**

```
{
    "result": "100"
}
```

### Set Max **Gas Fee**

Set max gas fee value for a specific maker on a given blockchain.

`POST /maker/setMaxGasFee`

**Parameters**

<table><thead><tr><th width="171.7142857142857">Name</th><th width="150">Type</th><th width="150">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>typedData</td><td>EIP712TypedData</td><td>Yes</td><td>Object created with "buildRFQOrderTypedData" method from limit order protocol library.</td></tr><tr><td>signature</td><td>String</td><td>Yes</td><td>String created with "buildOrderSignature" method from limit order protocol library.</td></tr><tr><td>publicKey</td><td>String</td><td>Yes</td><td>Session public key.</td></tr><tr><td>makerAddress</td><td>String</td><td>Yes</td><td>Address of maker wallet address.</td></tr><tr><td>chainId</td><td>Number</td><td>Yes</td><td>Id of a blockchain.</td></tr><tr><td>gasFee</td><td>Number</td><td>Yes</td><td>The gas fee value you want to set.</td></tr></tbody></table>

**Response**

```
{
    "result": "Max gas fee set successfully"
}
```


---

# 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.coinquoter.com/products/taker/api-documentation.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.