---
# System prepended metadata

title: APIs

---

# APIs

------
## BASE URL：
> * https://app.dforce.network

## POOL:
> * general
> * stocks

## NETWORK
> * kovan
> * mainnet
> * bsc

## PATH
* markets
> https://app.dforce.network/{POOL}/markets?network={NETWORK}
```
response：
{
    "supplyMarkets":[{
        "symbol": "iBUSD",
        "name": "dForce BUSD",
        "underlying_symbol": "BUSD",
        "decimals": "18",
        "address": "0x5511b64Ae77452C7130670C79298DEC978204a47",
        "supplyAPY": "0",
        "borrowAPY": "11006611770092223",
        "cash": "952879321925223294956952",
        "supplyValue": "1660735130520729016979459",
        "borrowValue": "710197810083155701055949"
    }],
    "mintMarkets":[{
        "symbol": "iMUSX",
        "name": "dForce USD",
        "underlying_symbol": "USX",
        "decimals": "18",
        "address": "0x36f4C36D1F6e8418Ecb2402F896B2A8fEDdE0991",
        "supplyAPY": "0",
        "borrowAPY": "30000000003489108",
        "cash": "0",
        "supplyValue": "0"
    }],
    "underlyingToken":[{
        "underlying": "0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56",
        "symbol": "BUSD",
        "price": "1000157630000000000",
        "priceStatus": "true"
    }],
    "totalSupplyValue": "20705384365443991577534855",
    "totalBorrowsValue": "3061906536013724871248720",
    "totalMintValue": "1536353211879959304383056"
}
```
* distribution
> https://app.dforce.network/{POOL}/distribution?network={NETWORK}
```
{
    "supplyMaining": [
        {
            "dailyDistribution": "14800000000000000032000",
            "totalDistributed": "20604888888888888400550",
            "rewardSupplyApy": "123047686946271957",
            "rewardBorrowApy": "260818664844410176",
            "supplyApy": "5904593314229626",
            "borrowApy": "13961861133508072",
            "mainingBorrowApy": "-246856803710902104",
            "mainingSupplyApy": "128952280260501583",
            "symbol": "iBUSD",
            "underlying_symbol": "BUSD",
            "address": "0x5511b64Ae77452C7130670C79298DEC978204a47",
            "underlyingAddress": "0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56"
    }
    
    ],
    "mintMaining": [...],
    "totalDaily": "80000000000000000409600",
    "totalDistributed": "113228090277777777211200",
    "remaining": "1006771909722222222788800",
    "rewardTokenSymbol": "DF",
    "rewardTokenDecimals": "18",
    "rewardTokenAddress": "0x4A9A2b2b04549C3927dd2c9668A5eF3fCA473623",
    "nowBlock": "8030649"
}
```
* liquidation：
> https://app.dforce.network/{POOL}/liquidation?network={NETWORK}
```
response：
[
    {
        "euqity": "0",
        "shortfall": "22348302210860838392330",
        "supplyValue": "31845730987839905623604",
        "collateralValue": "26274906095184406946706",
        "borrowedValue": "43368227087008363949695",
        "sumCollateral": "21019924876147525557365",
        "sumBorrowed": "43368227087008363949695",
        "collateralRatio": "484684901551910001",
        "userAddress": "0xA13f7166caDd3BD2704e3146E97dA2CcBe426b82"
    }
]
```
* liquidationV2：
> https://app.dforce.network/{POOL}/liquidationV2?network={NETWORK}&shortFallMin={number}&shortFallMax={number}&borrowedValueMin={number}&borrowedValueMax={number}&pageSize={number}&pageNumber={number}
```
response：
[
    {
        "euqity": "0",
        "shortfall": "22348302210860838392330",
        "supplyValue": "31845730987839905623604",
        "collateralValue": "26274906095184406946706",
        "borrowedValue": "43368227087008363949695",
        "sumCollateral": "21019924876147525557365",
        "sumBorrowed": "43368227087008363949695",
        "collateralRatio": "484684901551910001",
        "userAddress": "0xA13f7166caDd3BD2704e3146E97dA2CcBe426b82"
    }
]
```

* assets
> https://app.dforce.network/{POOL}/assets?network={NETWORK}
```
response：
{
    "0x2f956b2f801c6dad74E87E7f45c94f6283BF0f45": {
        "borrowIndex": "1000000000000000000",
        "decimals": "18",
        "supplyCapacity": "5000000000000000000000",
        "cash": "0",
        "symbol": "iMxETH",
        "controller": "0x8B53Ab2c0Df3230EA327017C91Eb909f815Ad113",
        "accrualBlockNumber": "12517414",
        "redeemPaused": "false",
        "reserveRatio": "0",
        "underlying_symbol": "xETH",
        "address": "0x028DB7A9d133301bD49f27b5E41F83F56aB0FaA6",
        "borrowCapacity": "0",
        "borrowFactor": "1000000000000000000",
        "price": "2694952770870000000000",
        "totalBorrows": "50000000000000000000",
        "distribution": "{\"asset\":\"0x028DB7A9d133301bD49f27b5E41F83F56aB0FaA6\",\"supplyDistributed\":\"0\",\"borrowDistributed\":\"0\",\"borrowSpeed\":\"0\",\"supplySpeed\":\"0\",\"distributionBlock\":\"0\"}",
        "flashloanFeeRatio": "800000000000000",
        "name": "dForce ETH",
        "totalSupply": "0",
        "underlying": "0x8d2Cb35893C01fa8B564c84Bd540c5109d9D278e",
        "totalReserves": "0",
        "isiToken": "false",
        "underlying_name": "dForce ETH",
        "protocolFeeRatio": "250000000000000000",
        "collateralFactor": "700000000000000000",
        "borrowRatePerBlock": "0",
        "mintPaused": "false",
        "borrowPaused": "false",
        "priceStatus": "true",
        "supplyRatePerBlock": "0",
        "interestRateModel": "0x786846D89736A5729e6A223F124bbB2377a8D337"
    }
}
```
* user
> https://app.dforce.network/{POOL}/users?address={ADDRESS}&network=NETWORK
```
response：
[
    {
        "0x390bf37355e9dF6Ea2e16eEd5686886Da6F47669": {
            "balanceOf": "0",
            "exchangeRate": "1000000018035878611",
            "earned": "0",
            "principal": "0",
            "interestIndex": "0",
            "accrued": "0",
            "asCollateral": false
        }
    }
]
```
* interest history
> TYPE = [borrow, supply]
> https://app.dforce.network/{POOL}/chart?network={NETWORK}&asset={ADDRESS}&type={TYPE}
```
response：
[
    {
		"apy": "0",
		"timeStamp": "1622911808"
	}
]
```
* liquidation history
> https://app.dforce.network/{POOL}/liquidationHistory?network={NETWORK}
```
response：
[
    {
		"0xe9a7faf07a85e9278a0da077aa8c71605896fc3846892a6b4a130cd2c432308f": {
			"transactionHash": "0xe9a7faf07a85e9278a0da077aa8c71605896fc3846892a6b4a130cd2c432308f",
			"logIndex": 259,
			"liquidator": "0x6e1C24586d0DFEB608E0442a8A1Ce772afEC03a6",
			"borrower": "0x1266F32eBb3725D6C9aC4240b18f8dCaDba58FFE",
			"repayAmount": "13550806285",
			"iTokenCollateral": "0x5812fCF91adc502a765E5707eBB3F36a07f63c02",
			"seizeTokens": "27132419",
			"timeStamp": "1622893933",
			"iTokenRepay": "0x2f956b2f801c6dad74E87E7f45c94f6283BF0f45"
		}
	},
]
```

* liquidation history V2
> https://app.dforce.network/{POOL}/liquidationHistoryV2?network={NETWORK}&liquidator={address}&borrower={address}&pageSize={number}&pageSize={number}
```
response：
{
    "totalCount": "5",
    "pageSize": "1",
    "pageNumber": "1",
    "data": [
                {
                    "transactionHash": "0x1f52c32126438fdef2b2ff88274bac382c9958ed05f463746df0a91802738703",
                    "logIndex": 1119,
                    "liquidator": "0xdFe89CAF65862c5B46FA22e8fA2296e05BfCBF94",
                    "borrower": "0x4adc6382D00a736eE8bc722E3fB60eFF88809D25",
                    "repayAmount": "267067193155148515820",
                    "iTokenCollateral": "0x0b66A250Dadf3237DdB38d485082a7BfE400356e",
                    "seizeTokens": "7210191963848654",
                    "timeStamp": "1632997743",
                    "iTokenRepay": "0x5511b64Ae77452C7130670C79298DEC978204a47"
                }
            ]
}
```
* all topics
> https://app.dforce.network/{POOL}/topics?network={NETWORK}
```
response：
{
	"topics": {
		"BorrowPaused": "0xa501bd5ac3de9924ce0c13576750267130fd835780f1ec6e1ae9fb13ee746503",
	},
	"allParameter": {
		"BorrowPaused": [
			"iToken",
			"paused"
		],
	},
	"allInput": {
		BorrowPaused": [
			{
				"indexed": false,
				"internalType": "address",
				"name": "iToken",
				"type": "address"
			},
		]
	}
}
```
* api status
> https://app.dforce.network/api_status.json
```
{
  "mainnet": {
    "server": {
      "general": {
        "serverBlock": 12593032,
        "chainBlock": 12593032
      },
      "stocks": {
        "serverBlock": 12593032,
        "chainBlock": 12593032
      }
    },
    "backup": {
      "general": {
        "serverBlock": 12593029,
        "chainBlock": 12593032
      },
      "stocks": {
        "serverBlock": 12593029,
        "chainBlock": 12593032
      }
    }
  }
}
```

* DF circulating
> https://api.dforce.network/baseinfo/df/circulating/

* DF basic info
> https://api.dforce.network/baseinfo/df/

```
{
  "price": "0.1164",
  "circulating": "390385530.3943541",
  "totalSupply": "999933029.3943541",
  "lockValue": "609547499.0"
}
```

* USDx Details
> https://api.dforce.network/baseinfo/usdx/

```
{
  "price": 1,
  "totalSupply": 928943.0543
}
```

* USDx Price
> https://api.dforce.network/baseinfo/usdx/price

```
1
```

* GOLDx Details
> https://api.dforce.network/baseinfo/goldx/

```
{
  "price": 61.811417815515725,
  "totalSupply": 12437.18135924373
}
```

* GOLDx Price
> https://api.dforce.network/baseinfo/goldx/price

```
61.811417815515725
```

* Gross Profit
> https://app.dforce.network/general/grossProfit?network=mainnet

```
{
  "0x1180c114f7fAdCB6957670432a3Cf8Ef08Ab5354": {
    "earned": "5217349104",
    "principal": "4598151426782",
    "balanceOf": "6638261393010",
    "decimals": "6",
    "price": "1000170800000000000000000000000",
    "symbol": "iUSDT",
    "earning": "5450042699328062800000"
  }
}
```


* deBank Open API
> https://api.debank.com/user/addr?addr=0x

> https://api.debank.com/token/balance_list?chain=bsc&is_all=false&user_addr=0x

> https://openapi.debank.com/v1/user/total_balance?id=0x