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

Name	Type	Mandatory	Description
chainId	Number	Yes	Id of a blockchain.

Response

{
    "address": "0xC9BdEC6F2C54d3577f5ccAD29a7f0fE9778b4d9f"
}

Native Token

Returns native currency of blockchain.

GET /getNativeToken

Parameters

Name	Type	Mandatory	Description
chainId	Number	Yes	Id of a blockchain.

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

Name	Type	Mandatory	Description
takerAddress	String	Yes	Address of taker wallet.

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 Token Pairs

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

GET /getActiveTokenPairs

Parameters

Name	Type	Mandatory	Description
chainId	Number	Yes	Id of a blockchain.

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

Name	Type	Mandatory	Description
chainId	Number	Yes	Id of a blockchain.
makerAddress	String	Yes	Address of maker wallet address.

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

Name	Type	Mandatory	Description
typedData	EIP712TypedData	Yes	Object created with "buildRFQOrderTypedData" method from limit order protocol library.
signature	String	Yes	String created with "buildOrderSignature" method from limit order protocol library.
publicKey	String	Yes	Session public key.
makerAddress	String	Yes	Address of maker wallet address.
chainId	Number	Yes	Id of a blockchain.

Response

{
    "result": "250"
}

Set Max Slippage

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

POST /maker/setMaxSlippage

Parameters

Name	Type	Mandatory	Description
typedData	EIP712TypedData	Yes	Object created with "buildRFQOrderTypedData" method from limit order protocol library.
signature	String	Yes	String created with "buildOrderSignature" method from limit order protocol library.
publicKey	String	Yes	Session public key.
makerAddress	String	Yes	Address of maker wallet address.
chainId	Number	Yes	Id of a blockchain.
slippage	Number	Yes	The slippage value you want to set.

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

Name	Type	Mandatory	Description
typedData	EIP712TypedData	Yes	Object created with "buildRFQOrderTypedData" method from limit order protocol library.
signature	String	Yes	String created with "buildOrderSignature" method from limit order protocol library.
publicKey	String	Yes	Session public key.
makerAddress	String	Yes	Address of maker wallet address.
chainId	Number	Yes	Id of a blockchain.

Response

{
    "result": "100"
}

Set Max Gas Fee

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

POST /maker/setMaxGasFee

Parameters

Name	Type	Mandatory	Description
typedData	EIP712TypedData	Yes	Object created with "buildRFQOrderTypedData" method from limit order protocol library.
signature	String	Yes	String created with "buildOrderSignature" method from limit order protocol library.
publicKey	String	Yes	Session public key.
makerAddress	String	Yes	Address of maker wallet address.
chainId	Number	Yes	Id of a blockchain.
gasFee	Number	Yes	The gas fee value you want to set.

Response

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