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

NameTypeMandatoryDescription

chainId

Number

Yes

Id of a blockchain.

Response

{
    "address": "0xC9BdEC6F2C54d3577f5ccAD29a7f0fE9778b4d9f"
}

Native Token

Returns native currency of blockchain.

GET /getNativeToken

Parameters

NameTypeMandatoryDescription

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

NameTypeMandatoryDescription

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

NameTypeMandatoryDescription

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

NameTypeMandatoryDescription

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

NameTypeMandatoryDescription

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

NameTypeMandatoryDescription

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

NameTypeMandatoryDescription

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

NameTypeMandatoryDescription

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"
}

Last updated