Crescent Docs
Search…
API Reference

Params

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/params

Example Response

{
"params": {
"batch_size": 1,
"tick_precision": 3,
"fee_collector_address": "cre1zdew6yxyw92z373yqp756e0x4rvd2het37j0a2wjp7fj48eevxvq303p8d",
"dust_collector_address": "cre1suads2mkd027cmfphmk9fpuwcct4d8ys02frk8e64hluswfwfj0s4xymnj",
"initial_pool_coin_supply": "1000000000000",
"pair_creation_fee": [
{
"denom": "stake",
"amount": "1000000"
}
],
"pool_creation_fee": [
{
"denom": "stake",
"amount": "1000000"
}
],
"min_initial_deposit_amount": "1000000",
"max_price_limit_ratio": "0.100000000000000000",
"max_order_lifespan": "86400s",
"swap_fee_rate": "0.000000000000000000",
"withdraw_fee_rate": "0.000000000000000000"
}
}

Pairs

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pairs
http://localhost:1317/crescent/liquidity/v1beta1/pairs?denoms=uatom
http://localhost:1317/crescent/liquidity/v1beta1/pairs?denoms=uatom&denoms=uusd

Example Response

{
"pairs": [
{
"id": "1",
"base_coin_denom": "uatom",
"quote_coin_denom": "uusd",
"escrow_address": "cre17u9nx0h9cmhypp6cg9lf4q8ku9l3k8mz232su7m28m39lkz25dgqw9sanj",
"last_order_id": "4",
"last_price": "0.310500000000000000",
"current_batch_id": "5"
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}

Pair

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pairs/1
Example Response
{
"pair": {
"id": "1",
"base_coin_denom": "uatom",
"quote_coin_denom": "uusd",
"escrow_address": "cre17u9nx0h9cmhypp6cg9lf4q8ku9l3k8mz232su7m28m39lkz25dgqw9sanj",
"last_order_id": "4",
"last_price": "0.310500000000000000",
"current_batch_id": "5"
}
}

Pools

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pools
http://localhost:1317/crescent/liquidity/v1beta1/pools?pair_id=1
http://localhost:1317/crescent/liquidity/v1beta1/pools?disabled=false

Example Response

{
"pools": [
{
"id": "1",
"pair_id": "1",
"reserve_address": "cre1353ausz7n8arsyf6dp0mq7gvj4ry2c2ht284kzrrft2mx7rdvfnsxuuamx",
"pool_coin_denom": "pool1",
"balances": [
{
"denom": "uatom",
"amount": "1636000001"
},
{
"denom": "uusd",
"amount": "476957901"
}
],
"last_deposit_request_id": "1",
"last_withdraw_request_id": "1"
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}

Pool

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pools/1

Example Response

{
"pool": {
"id": "1",
"pair_id": "1",
"reserve_address": "cre1353ausz7n8arsyf6dp0mq7gvj4ry2c2ht284kzrrft2mx7rdvfnsxuuamx",
"pool_coin_denom": "pool1",
"balances": [
{
"denom": "uatom",
"amount": "1636000001"
},
{
"denom": "uusd",
"amount": "476957901"
}
],
"last_deposit_request_id": "1",
"last_withdraw_request_id": "1"
}
}

PoolByReserveAddress

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pools/reserve_address/cre1353ausz7n8arsyf6dp0mq7gvj4ry2c2ht284kzrrft2mx7rdvfnsxuuamx

Example Response

{
"pool": {
"id": "1",
"pair_id": "1",
"reserve_address": "cre1353ausz7n8arsyf6dp0mq7gvj4ry2c2ht284kzrrft2mx7rdvfnsxuuamx",
"pool_coin_denom": "pool1",
"balances": [
{
"denom": "uatom",
"amount": "1636000001"
},
{
"denom": "uusd",
"amount": "476957901"
}
],
"last_deposit_request_id": "1",
"last_withdraw_request_id": "1"
}
}

PoolByPoolCoinDenom

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pools/pool_coin_denom/pool1

Example Response

{
"pool": {
"id": "1",
"pair_id": "1",
"reserve_address": "cre1353ausz7n8arsyf6dp0mq7gvj4ry2c2ht284kzrrft2mx7rdvfnsxuuamx",
"pool_coin_denom": "pool1",
"balances": [
{
"denom": "uatom",
"amount": "1636000001"
},
{
"denom": "uusd",
"amount": "476957901"
}
],
"last_deposit_request_id": "1",
"last_withdraw_request_id": "1"
}
}

DepositRequests

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pools/1/deposit_requests

Example Response

{
"deposit_requests": [
{
"id": "2",
"pool_id": "1",
"msg_height": "1849",
"depositor": "cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p",
"deposit_coins": [
{
"denom": "uatom",
"amount": "30000000"
},
{
"denom": "uusd",
"amount": "10000000"
}
],
"accepted_coins": [
{
"denom": "uatom",
"amount": "30000000"
},
{
"denom": "uusd",
"amount": "8746172"
}
],
"minted_pool_coin": {
"denom": "pool1",
"amount": "9352078233"
},
"status": "REQUEST_STATUS_SUCCEEDED"
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}

DepositRequest

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pools/1/deposit_requests/1

Example Response

{
"deposit_request": {
"id": "5",
"pool_id": "1",
"msg_height": "1929",
"depositor": "cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p",
"deposit_coins": [
{
"denom": "uatom",
"amount": "30000000"
},
{
"denom": "uusd",
"amount": "10000000"
}
],
"accepted_coins": [
{
"denom": "uatom",
"amount": "30000000"
},
{
"denom": "uusd",
"amount": "8746172"
}
],
"minted_pool_coin": {
"denom": "pool1",
"amount": "9352078233"
},
"status": "REQUEST_STATUS_SUCCEEDED"
}
}

WithdrawRequests

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pools/1/withdraw_requests

Example Response

{
"withdraw_requests": [
{
"id": "2",
"pool_id": "1",
"msg_height": "1987",
"withdrawer": "cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p",
"pool_coin": {
"denom": "pool1",
"amount": "10000000"
},
"withdrawn_coins": [
{
"denom": "uatom",
"amount": "32078"
},
{
"denom": "uusd",
"amount": "9352"
}
],
"status": "REQUEST_STATUS_SUCCEEDED"
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}

WithdrawRequest

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pools/1/withdraw_requests/1

Example Response

{
"withdraw_request": {
"id": "3",
"pool_id": "1",
"msg_height": "2016",
"withdrawer": "cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p",
"pool_coin": {
"denom": "pool1",
"amount": "10000000"
},
"withdrawn_coins": [
{
"denom": "uatom",
"amount": "32078"
},
{
"denom": "uusd",
"amount": "9352"
}
],
"status": "REQUEST_STATUS_SUCCEEDED"
}
}

Orders

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pairs/1/orders

Example Response

{
"orders": [
{
"id": "5",
"pair_id": "1",
"msg_height": "2129",
"orderer": "cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p",
"direction": "ORDER_DIRECTION_SELL",
"offer_coin": {
"denom": "uatom",
"amount": "1000000"
},
"remaining_offer_coin": {
"denom": "uatom",
"amount": "0"
},
"received_coin": {
"denom": "uusd",
"amount": "291300"
},
"price": "0.279500000000000000",
"amount": "1000000",
"open_amount": "0",
"batch_id": "5",
"expire_at": "2022-03-15T11:30:20.044978Z",
"status": "ORDER_STATUS_COMPLETED"
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}

Order

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/pairs/1/orders/1

Example Response

{
"order": {
"id": "8",
"pair_id": "1",
"msg_height": "2280",
"orderer": "cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p",
"direction": "ORDER_DIRECTION_SELL",
"offer_coin": {
"denom": "uatom",
"amount": "1000000"
},
"remaining_offer_coin": {
"denom": "uatom",
"amount": "0"
},
"received_coin": {
"denom": "uusd",
"amount": "290300"
},
"price": "0.261700000000000000",
"amount": "1000000",
"open_amount": "0",
"batch_id": "8",
"expire_at": "2022-03-15T11:33:08.772980Z",
"status": "ORDER_STATUS_COMPLETED"
}
}

OrdersByOrderer

Example Request

http://localhost:1317/crescent/liquidity/v1beta1/orders/cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p

Example Response

{
"orders": [
{
"id": "7",
"pair_id": "1",
"msg_height": "2242",
"orderer": "cre1zaavvzxez0elundtn32qnk9lkm8kmcszxclz6p",
"direction": "ORDER_DIRECTION_SELL",
"offer_coin": {
"denom": "uatom",
"amount": "1000000"
},
"remaining_offer_coin": {
"denom": "uatom",
"amount": "0"
},
"received_coin": {
"denom": "uusd",
"amount": "290700"
},
"price": "0.261900000000000000",
"amount": "1000000",
"open_amount": "0",
"batch_id": "7",
"expire_at": "2022-03-15T11:32:26.216376Z",
"status": "ORDER_STATUS_COMPLETED"
}
],
"pagination": {
"next_key": null,
"total": "1"
}
}
Copy link
On this page
Params
Pairs
Pair
Pools
Pool
PoolByReserveAddress
PoolByPoolCoinDenom
DepositRequests
DepositRequest
WithdrawRequests
WithdrawRequest
Orders
Order
OrdersByOrderer