/tokenbch Endpoints
Base URL: /tokenbch
Available Endpoints
/pool/active?<token>&<pkh>
Endpoint: GET /pool/active
Status: Stable
Description: Get list of active pools for given token and/or user. Either user or token ID must be provided.
- user: 20 byte hash of a users pkh
-
token: byte token ID.
-
token: Token ID or symbol
- pkh: Public key hash
Response Example:
{
"active": [
{
"owner_p2pkh_addr": "bitcoincash:zqmvqqsd6w08e4nvy8er0hzn6wzxvxj40u7tlk8wl3",
"owner_pkh": "36c0020dd39e7cd66c21f237dc53d384661a557f",
"sats": 776661580,
"token_id": "b79bfc8246b5fc4707e7c7dedcb6619ef1ab91f494a790c20b0f4c422ed95b92",
"tokens": 16,
"tx_pos": 0,
"txid": "94a933a0fa55093a0965eb867f1b9cac2bb07488ced4825bc31f86c9371f76aa"
}
]
}
Example URI: /pool/active
/pools
Endpoint: GET /pools
Status: Unstable
Description: List ALL active TokenBch pools, regardless of token — every pool at its latest state. Drives the frontend pooled-pair selector, so it can present the tokens that have BCH liquidity without probing each candidate individually.
Example URI: /pools
/tokens
Endpoint: GET /tokens
Status: Unstable
Description: List the token ids that appear in at least one active TokenBch pool. Drives the frontend token selector and the "no route" decision.
Example URI: /tokens