> For the complete documentation index, see [llms.txt](https://www.pionex.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.pionex.com/docs/api-docs/inst-fund-api/inst-fund-common.md).

# Inst Fund Common

Fiat deposit / withdrawal history and fee query endpoints (private)

## Query fiat deposit history

> Returns fiat deposit history for the authenticated user. Weight: 1.<br>

```json
{"openapi":"3.0.3","info":{"title":"Pionex InstFund Open API","version":"1.0.0"},"tags":[{"name":"InstFund - Common","description":"Fiat deposit / withdrawal history and fee query endpoints (private)"}],"servers":[{"url":"https://api.pionex.com","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"TradeToken","description":"Trade Token authentication. Provide the token in the `Authorization` header as `Bearer <trade_token>`. The Trade Token is issued by the Pionex Trade Token Service and is verified on every request.\n"}},"schemas":{"BaseResponse":{"type":"object","properties":{"result":{"type":"boolean","description":"Success indicator"},"timestamp":{"type":"integer","format":"int64","description":"Response timestamp in milliseconds"},"code":{"type":"string","description":"Error code (present only on failure)"},"message":{"type":"string","description":"Error message (present only on failure)"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - Missing or invalid Trade Token","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"}]}}}},"InternalError":{"description":"Internal error - service or business error. A human-readable `message` is returned when available.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"}]}}}}}},"paths":{"/api/v1/instFund/common/getDeposits":{"get":{"tags":["InstFund - Common"],"summary":"Query fiat deposit history","description":"Returns fiat deposit history for the authenticated user. Weight: 1.\n","operationId":"instFundGetDeposits","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"data":{"type":"object","description":"Deposit history"}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Query fiat withdrawal history

> Returns fiat withdrawal history for the authenticated user. Weight: 1.<br>

```json
{"openapi":"3.0.3","info":{"title":"Pionex InstFund Open API","version":"1.0.0"},"tags":[{"name":"InstFund - Common","description":"Fiat deposit / withdrawal history and fee query endpoints (private)"}],"servers":[{"url":"https://api.pionex.com","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"TradeToken","description":"Trade Token authentication. Provide the token in the `Authorization` header as `Bearer <trade_token>`. The Trade Token is issued by the Pionex Trade Token Service and is verified on every request.\n"}},"schemas":{"BaseResponse":{"type":"object","properties":{"result":{"type":"boolean","description":"Success indicator"},"timestamp":{"type":"integer","format":"int64","description":"Response timestamp in milliseconds"},"code":{"type":"string","description":"Error code (present only on failure)"},"message":{"type":"string","description":"Error message (present only on failure)"}}}},"responses":{"Unauthorized":{"description":"Unauthorized - Missing or invalid Trade Token","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"}]}}}},"InternalError":{"description":"Internal error - service or business error. A human-readable `message` is returned when available.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"}]}}}}}},"paths":{"/api/v1/instFund/common/getWithdraws":{"get":{"tags":["InstFund - Common"],"summary":"Query fiat withdrawal history","description":"Returns fiat withdrawal history for the authenticated user. Weight: 1.\n","operationId":"instFundGetWithdraws","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"data":{"type":"object","description":"Withdrawal history"}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
```

## Query withdrawal fee

> Query the withdrawal fee for a given amount and channel. Currently only the withdrawal direction is supported. Weight: 1.\
> \
> Example request:\
> \`\`\`\
> GET /api/v1/instFund/common/getFee?amount=100\&direction=withdraw\
> \`\`\`\
> \
> Example response:\
> \`\`\`json\
> {\
> &#x20; "result": true,\
> &#x20; "data": {\
> &#x20;   "totalAmount": "100",\
> &#x20;   "fee": "0.5",\
> &#x20;   "netAmount": "99.5"\
> &#x20; },\
> &#x20; "timestamp": 1774959429596\
> }\
> \`\`\`<br>

````json
{"openapi":"3.0.3","info":{"title":"Pionex InstFund Open API","version":"1.0.0"},"tags":[{"name":"InstFund - Common","description":"Fiat deposit / withdrawal history and fee query endpoints (private)"}],"servers":[{"url":"https://api.pionex.com","description":"Production"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"TradeToken","description":"Trade Token authentication. Provide the token in the `Authorization` header as `Bearer <trade_token>`. The Trade Token is issued by the Pionex Trade Token Service and is verified on every request.\n"}},"schemas":{"BaseResponse":{"type":"object","properties":{"result":{"type":"boolean","description":"Success indicator"},"timestamp":{"type":"integer","format":"int64","description":"Response timestamp in milliseconds"},"code":{"type":"string","description":"Error code (present only on failure)"},"message":{"type":"string","description":"Error message (present only on failure)"}}},"GetFeeData":{"type":"object","description":"Withdrawal fee query result","properties":{"totalAmount":{"type":"string","description":"Total amount requested"},"fee":{"type":"string","description":"Withdrawal fee"},"netAmount":{"type":"string","description":"Amount credited to the counterparty (for withdrawal: total amount minus fee)"}}}},"responses":{"BadRequest":{"description":"Bad Request - Invalid parameters","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"}]}}}},"Unauthorized":{"description":"Unauthorized - Missing or invalid Trade Token","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"}]}}}},"InternalError":{"description":"Internal error - service or business error. A human-readable `message` is returned when available.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"}]}}}}}},"paths":{"/api/v1/instFund/common/getFee":{"get":{"tags":["InstFund - Common"],"summary":"Query withdrawal fee","description":"Query the withdrawal fee for a given amount and channel. Currently only the withdrawal direction is supported. Weight: 1.\n\nExample request:\n```\nGET /api/v1/instFund/common/getFee?amount=100&direction=withdraw\n```\n\nExample response:\n```json\n{\n  \"result\": true,\n  \"data\": {\n    \"totalAmount\": \"100\",\n    \"fee\": \"0.5\",\n    \"netAmount\": \"99.5\"\n  },\n  \"timestamp\": 1774959429596\n}\n```\n","operationId":"instFundGetFee","parameters":[{"name":"channel","in":"query","required":false,"description":"Optional channel identifier. Leave empty to use the default channel bound to your account.","schema":{"type":"string"}},{"name":"amount","in":"query","required":true,"description":"Total amount to query the fee for (decimal string, in the quote currency U).","schema":{"type":"string"}},{"name":"direction","in":"query","required":false,"description":"Fee direction. Only `withdraw` is currently supported; defaults to `withdraw`.","schema":{"type":"string","default":"withdraw","enum":["withdraw"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/GetFeeData"}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}}}}
````
