Data Queries

Get Mining Points

This endpoint allows querying user liquidity pool shares (lp), mining points (integral), and other data.

POST /brc20swap/manage_liquid_info

Parameters

{
    "page": 1,
    "page_size": 15,
    "address": "tb1qge80xavle7c7k0tk7vceaavwcgpsr3jchl0w3e"
}

cURL Example

curl 'https://test-api-proxy.ddpurse.com/brc20swap/manage_liquid_info' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Accept-Language: en' \
  -H 'Cache-Control: no-cache' \
  -H 'Connection: keep-alive' \
  -H 'Content-Type: application/json' \
  -H 'Origin: http://192.168.10.66:56651' \
  -H 'Pragma: no-cache' \
  -H 'Referer: http://192.168.10.66:56651/' \
  -H 'Sec-Fetch-Dest: empty' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Site: cross-site' \
  -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36' \
  -H 'sec-ch-ua: "Not A(Brand";v="99", "Google Chrome";v="121", "Chromium";v="121"' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'sec-ch-ua-platform: "macOS"' \
  --data-raw '{"page":1,"page_size":15,"address":"tb1qge80xavle7c7k0tk7vceaavwcgpsr3jchl0w3e"}' \
  --compressed

1. The response includes a protocol field to indicate the type of pool (brc20, arc20).

Query Liquidity Operations History

This endpoint allows querying the history of user operations related to creating, adding, and removing liquidity pools. The txid can be used to query the on-chain transaction status in the mempool.

POST /brc20swap/liquid_history

Parameters

{
    "page": 1,
    "page_size": 15,
    "address": "tb1qlphav0389832xt8deme0hx2unvw3cjt7fsfuyx"
}

cURL Example

curl 'https://test-api-proxy.ddpurse.com/brc20swap/liquid_history' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Accept-Language: en' \
  -H 'Cache-Control: no-cache' \
  -H 'Connection: keep-alive' \
  -H 'Content-Type: application/json' \
  -H 'Origin: http://localhost:56651' \
  -H 'Pragma: no-cache' \
  -H 'Referer: http://localhost:56651/' \
  -H 'Sec-Fetch-Dest: empty' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Site: cross-site' \
  -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36' \
  -H 'sec-ch-ua: "Chromium";v="122", "Not(A:Brand";v="24", "Google Chrome";v="122"' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'sec-ch-ua-platform: "macOS"' \
  --data-raw '{"page":1,"page_size":15,"address":"tb1qlphav0389832xt8deme0hx2unvw3cjt7fsfuyx"}'

1. The response includes an array txs, where the txid field represents the transaction hash for querying transaction status. A status other than confirmed indicates the transaction is unconfirmed.

Liquidity Pool Information List

This endpoint allows querying the Total Value Locked (TVL) of pools.

POST /brc20swap/stat/trade_info_list

Parameters

{
    "page": 1,
    "page_size": 8,
    "crypto_type": "btc"
}

cURL Example

curl 'https://test-api-proxy.ddpurse.com/brc20swap/stat/trade_info_list' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Accept-Language: en' \
  -H 'Cache-Control: no-cache' \
  -H 'Connection: keep-alive' \
  -H 'Content-Type: application/json' \
  -H 'Origin: http://localhost:56651' \
  -H 'Pragma: no-cache' \
  -H 'Referer: http://localhost:56651/' \
  -H 'Sec-Fetch-Dest: empty' \
  -H 'Sec-Fetch-Mode: cors' \
  -H 'Sec-Fetch-Site: cross-site' \
  -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36' \
  -H 'sec-ch-ua: "Google Chrome";v="123", "Not:A-Brand";v="8", "Chromium";v="123"' \
  -H 'sec-ch-ua-mobile: ?0' \
  -H 'sec-ch-ua-platform: "macOS"' \
  --data-raw '{"page":1,"page_size":8,"crypto_type":"btc"}'

1. Values returned with _btc are in BTC units; otherwise, values are in USD.

2. The TVL field includes pool_locked_amount_btc and pool_locked_amount.

Get Liquidity Pool Address by Token Pair

POST /brc20swap/get_liquid_address

Parameter

{
    "tick1": "btc",
    "tick2": "yydd",
    "coin_type_1": "btc",
    "coin_type_2": "brc20"
}

cURL Example

curl --location --request POST 'https://test-api-proxy.ddpurse.com/brc20swap/get_liquid_address' \
--header 'Authorization;' \
--header 'User-Id;' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Host: test-api-proxy.ddpurse.com' \
--header 'Connection: keep-alive' \
--data-raw '{
    "tick1": "btc",
    "tick2": "yydd",
    "coin_type_1": "btc",
    "coin_type_2": "brc20"
}'

Get Pool APR

POST /brc20swap/external/pool/apr

Parameters

{
   "coin_type_1":"btc",
   "coin_type_2" : "runes",
   "tick1":"btc",
   "tick2" :"MOLLY•GAME•N•B•C"
}

cURL Example

curl --location --request POST 'https://test-api-proxy.ddpurse.com/brc20swap/external/pool/apr' \
--header 'Pragma: no-cache' \
--header 'Authorization;' \
--header 'User-Id;' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/json' \
--header 'Host: test-api-proxy.ddpurse.com' \
--data-raw '{
   "coin_type_1":"btc",
   "coin_type_2" : "runes",
   "tick1":"btc",
   "tick2" :"MOLLY•GAME•N•B•C"
}'