Ctrl+K

Get addresses by chain (without token filter)

post/api/v2/internal/{coin}/getaddressesbychain

Internal route to get addresses by chain only, allowing searches across all OFC tokens within the chain.

Path Parameters

  • coinstringRequired
    The coin identifier
    Min length: >= 1 characters

Request Body

addresses array[string] required
Array of addresses to search for

200 Response

chainAddresses array[object] required
Address JSON representation matching the AddressJSON interface This is the complete address model as returned by the API
id string required
Platform public ID for an address
coin string required
The coin/chain for this address
Example: btc
wallet string required
Wallet ID containing this address
chain number required
Chain index (0 for receive addresses, 1 for change addresses, etc.)
Allowed values: 0 1 10 11 20 21 30 31 40 41
index number required
Address index within the chain
address string
The address string
balance object
Balance information (not in DB but annotated in API)
coinSpecificOne of
Properties specific to certain coin types
label string
User-defined label for this address
Max length: <= 250 characters
Example: Bob's Hot Wallet Address
lastNonce number
Last nonce used for this address
token string
Token identifier if this is a token address
proof string
Proof data
signature string
Signature data
lastConsolidatedTimeOne of
Last time this address was consolidated
needsConsolidation boolean
Whether this address needs consolidation
tokenConsolidationState dictionary<string, boolean>
Token consolidation state mapping
tokenAddress dictionary<string, object>
Token addresses (not in DB but annotated in API)
nonceTracking object
Nonce tracking information
referenceAddressId string
Reference address ID for EVM keyring wallets

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

404 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

500 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id