GET https://api.cryptohopper.com/v1/hopper/{id}/position/sync

Compares the hopper's stored exchange balances with its open positions, open orders and reserved funds, and returns coin amounts that no position covers (unsynced) and amounts too small to trade (dust).

OAuth scope: read About scopes

unsynced and dust are null when empty. On exchanges that support converting dust, an extra exchange object with the convertible assets can be included. Use Sync a position to add an unsynced amount as a position. Not available for exchange arbitrage, market maker, copy and grid bots.

Example request

curl "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/position/sync" \
  -H "access-token: YOUR_ACCESS_TOKEN"

Parameters

Headers

NameTypeRequiredDescription
access-token string Required The OAuth access token of the user.

Path parameters

NameTypeRequiredDescription
id string Required Hopper ID.

Response

Example response (illustrative values)

{
    "data": {
        "unsynced": [
            {
                "pair": "ETHUSDT",
                "cur": "ETH",
                "amount": 0.25,
                "rate": "3120.45000000"
            }
        ],
        "dust": null
    }
}

Status codes: 200. Errors return JSON with status, error and message. See How the API works for response codes and rate limits.