Integrations

GET /v1/integrations

Base URL: https://connect.kryptos.io/api

Retrieve a paginated list of user-connected wallets and exchanges with metadata, sync status, and transaction counts.

Required Permission: integrations:read

Request

curl -X GET "https://connect.kryptos.io/api/v1/integrations?page=1&pageSize=25" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-Client-Id: YOUR_CLIENT_ID" \
  -H "X-Client-Secret: YOUR_CLIENT_SECRET"

Query Parameters

Parameter	Type	Default	Description
page	number	1	Page number for pagination
pageSize	number	25	Number of items per page (max: 200)
searchedKey	string	-	Optional search term for fuzzy search

Response

{
  "data": [
    {
      "provider": "binance",
      "providerPublicName": "Binance",
      "publicAddress": null,
      "walletId": "wallet_abc123",
      "logoUrl": "https://...",
      "isContract": false,
      "alias": "Main Trading Account",
      "status": "active",
      "addedOn": 1640995200000,
      "lastSyncedAt": 1672531200000,
      "category": "exchange",
      "type": "api",
      "totalTransactions": 1542
    },
    {
      "provider": "ethereum",
      "providerPublicName": "Ethereum",
      "publicAddress": "0x1234...abcd",
      "walletId": "wallet_def456",
      "logoUrl": "https://...",
      "isContract": false,
      "alias": "DeFi Wallet",
      "status": "PARTIALLY SYNCED",
      "message": "We have been notified of the issue with ethereum and will fix it soon. Your account will be resynced.",
      "lastSyncLog": {
        "Balances": "COMPLETED",
        "Defi Balances": "COMPLETED",
        "NFT Holdings": "FAILED",
        "Transactions": "FAILED"
      },
      "limitExceeded": true,
      "addedOn": 1641081600000,
      "lastSyncedAt": 1672617600000,
      "category": "blockchain",
      "type": "api",
      "totalTransactions": 328
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "totalCount": 12,
    "hasNextPage": false,
    "hasPreviousPage": false
  },
  "user_id": "user_123",
  "timestamp": 1672531200000
}

Response Fields

Integration Object

Field	Type	Description
provider	string	Provider identifier (e.g., binance, ethereum)
providerPublicName	string	Human-readable provider name
publicAddress	string	Wallet address (for blockchain wallets)
walletId	string	Unique wallet/integration identifier
logoUrl	string	Provider logo URL
isContract	boolean	Whether the address is a smart contract
alias	string	User-defined alias for the integration
status	string	Sync status: ONGOING, COMPLETED, PARTIALLY SYNCED, FAILED. Defaults to active when never synced.
message	string	Human-readable message from the last sync failure. Omitted when there is no error.
lastSyncLog	object	Per-function sync result e.g. { "Transactions": "FAILED", "Balances": "COMPLETED" }. Omitted when no sync has run.
limitExceeded	boolean	true when the last sync failed due to the user's transaction limit being reached. The field is omitted entirely otherwise (it is never returned as false).
addedOn	number	Timestamp when integration was added (ms)
lastSyncedAt	number	Timestamp of last successful sync (ms)
category	string	Category: exchange, wallet, blockchain, unknown
type	string	Integration type: api or csv
totalTransactions	number	Total number of transactions from this integration

Pagination Object

Field	Type	Description
page	number	Current page number
pageSize	number	Items per page
totalCount	number	Total number of integrations
hasNextPage	boolean	Whether more pages exist
hasPreviousPage	boolean	Whether previous pages exist

Search

The searchedKey parameter enables fuzzy search across multiple fields:

• alias - User-defined integration name
• address - Wallet address
• accountName - Account name
• walletId - Wallet identifier
• public_name - Provider public name
• exchange - Exchange name

curl -X GET "https://connect.kryptos.io/api/v1/integrations?searchedKey=binance" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-Client-Id: YOUR_CLIENT_ID" \
  -H "X-Client-Secret: YOUR_CLIENT_SECRET"

Integration Categories

Category	Description
exchange	Centralized exchanges (Binance, Coinbase)
wallet	Software/hardware wallets (MetaMask, Ledger)
blockchain	Direct blockchain connections (Ethereum, Bitcoin)
unknown	Unclassified integrations

Integration Types

Type	Description
api	Connected via API keys or OAuth
csv	Imported via CSV file upload