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": "Unable to fetch transactions for ethereum due to transaction limit reached, kindly update your plan",
      "lastSyncLog": {
        "Balances": "COMPLETED",
        "Defi Balances": "COMPLETED",
        "NFT Holdings": "FAILED",
        "Transactions": "FAILED"
      },
      "lastSyncLogDetails": {
        "Balances": { "status": "COMPLETED" },
        "Defi Balances": { "status": "COMPLETED" },
        "NFT Holdings": {
          "status": "FAILED",
          "message": "We have been notified of the issue with ethereum and will fix it soon. Your account will be resynced."
        },
        "Transactions": {
          "status": "FAILED",
          "message": "Unable to fetch transactions for ethereum due to transaction limit reached, kindly update your plan",
          "limitExceeded": true
        }
      },
      "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	Wallet-level summary message. When any stage hit the transaction-import limit, this carries the limit-exceeded message; otherwise it's the message from the most relevant failed stage. Omitted when there is no error.
lastSyncLog	object	Per-function status map, e.g. { "Transactions": "FAILED", "Balances": "COMPLETED" }. Omitted when no sync has run.
lastSyncLogDetails	object	Per-function detail map. Each stage carries { status, message?, limitExceeded? }, so you can show stage-specific failure reasons without parsing the wallet-level message. lastSyncLog is the flattened (status-only) view of this object — both convey the same per-stage status and are emitted together. Omitted when no sync has run.
limitExceeded	boolean	true when the last sync failed due to the user's transaction limit being reached on any stage. 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