Positions API

positions

This endpoint is used to return current info about your positions in BLOOD All positions in BLOOD are stored locally on your machine in memory (instance) and in db file (to reactivate / sell / remove on the next startup) Active positions are the one that were opened in the active blood instance (they can be active or inactive). Instances do not share active positions between them Active position is the one that is being updated once a while (depends on your position update delay) and can be sold / removed automatically by bot (strategies and remove rules) Inactive position is the one that are just stored in memory, its not being updated but you can activate it again Positions in memory are fast access, we don't need to spend time to fetch additional info, only update the existing position Positions in db are slow access, each time we want to do any action with those positions we need to refetch info (if anything changes) and then update it There are 3 possible variants to fetch positions

• set fetchMemory to true and fetchDb to false so the bot will return all positions that are currently stored in memory (they can be active or inactive)

• set fetchMemory to false and fetchDb to true so the bot will return all positions that are stored in memory (it won't activate it - just refetch and update)

• set fetchMemory to true and fetchDb to true so the bot will do both things above

post

/api/v1/quick-task/positions

Body

fetchMemoryboolean

fetchDbboolean

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/quick-task/positions' \
  --header 'Content-Type: application/json' \
  --data '{
    "fetchMemory": true,
    "fetchDb": true
  }'

200

default

200

{
  "positions": [
    {
      "id": "text",
      "walletName": "text",
      "walletAddress": "text",
      "initialAmountIn": "text",
      "left": "text",
      "value": "text",
      "profit": "text",
      "profitTotal": "text",
      "mcap": "text",
      "extended": {
        "tokenIn": {
          "tokenAddress": "text",
          "tokenName": "text",
          "tokenSymbol": "text",
          "tokenDecimals": 1,
          "uri": "text",
          "mintAuthorityEnabled": true,
          "freezeAuthorityEnabled": true
        },
        "tokenOut": {
          "tokenAddress": "text",
          "tokenName": "text",
          "tokenSymbol": "text",
          "tokenDecimals": 1,
          "uri": "text",
          "mintAuthorityEnabled": true,
          "freezeAuthorityEnabled": true
        },
        "pool": {
          "poolId": "text",
          "platform": "text",
          "formattedLiquidityA": "text",
          "formattedLiquidityB": "text"
        },
        "shitcoinIsA": true,
        "strategy": "text",
        "strategyDisabled": true,
        "usefulLinks": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      },
      "active": true
    }
  ]
}

OK

sell

This endpoint is used to sell provided position by id and percentageToSell If the position is not found in memory the bot will automatically try to find it in db. If position is not found in both memory and db it will return an error If position token balance after refetching is 0 the bot will automatically remove it and return successful response ATTENTION - percentageToSell should be an integer in bps format 100% = 10000 10% = 1000 1% = 100

post

/api/v1/quick-task/positions/sell

Body

idstring

percentageToSellstring

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/quick-task/positions/sell' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "percentageToSell": "text"
  }'

200

default

200

{}

OK

position-reactivate

This endpoint is used to activate position by id If the position is not found in memory the bot will automatically try to find it in db. If position is not found in both memory and db it will return an error If position token balance after refetching is 0 the bot will return error - so you should remove it by calling POST /api/v1/quick-task/positions/remove endpoint

post

/api/v1/quick-task/positions/reactivate

Body

idstring

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/quick-task/positions/reactivate' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text"
  }'

200

default

200

{}

OK

position-deactivate

This endpoint is used to activate position by id

Deactivate is only affecting positions in that are stored in memory. If position is not found the bot will still return successful response

post

/api/v1/quick-task/positions/deactivate

Body

idstring

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/quick-task/positions/deactivate' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text"
  }'

200

default

200

{}

OK

remove

This endpoint is used to remove positions by ids both from memory and db

post

/api/v1/quick-task/positions/remove

Body

idsstring[]

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/quick-task/positions/remove' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": [
      "text"
    ]
  }'

200

default

200

{}

OK

position-strategy-deactivate

This endpoint is used to disable position strategies by ids. The bot won't check for any sell triggers based on strategies but still will keep updating positions.

post

/api/v1/quick-task/positions/strategies/deactivate

Body

idsstring[]

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/quick-task/positions/strategies/deactivate' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": [
      "text"
    ]
  }'

200

default

200

{}

OK

position-strategy-activate

This endpoint is used to enable position strategies by ids

post

/api/v1/quick-task/positions/strategies/activate

Body

idsstring[]

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/quick-task/positions/strategies/activate' \
  --header 'Content-Type: application/json' \
  --data '{
    "ids": [
      "text"
    ]
  }'

200

default

200

{}

OK

position-strategy-set

This endpoint is used to set or replace the existing position strategy by id. strategy input should match string format as in task file. The bot won't automatically enable position strategies if disabled by default so you need to externally call POST /api/v1/quick-task/positions/strategies/activate

post

/api/v1/quick-task/positions/strategy

Body

idstring

strategystring

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/v1/quick-task/positions/strategy' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "text",
    "strategy": "text"
  }'

200

default

200

{}

OK