Appearance
Which API to use
The platform exposes five HTTP APIs. Picking the right one is mostly a question of who holds the keys and what you are reading.
| API | Base URL | Purpose | Auth |
|---|---|---|---|
| Chain data | https://api.testnet.kriptonyx.com/api/v2 | Blocks, transactions, addresses, tokens, logs | None |
| Platform REST | https://endpoint.testnet.kriptonyx.com | Managed wallets, tokens, pools, swaps | Password |
| Bridge | https://bridge.testnet.kriptonyx.com/api | Cross-chain swaps, webhooks | None / bearer |
| ICO | https://ico.testnet.kriptonyx.com/api | Launchpad | Wallet signature → JWT |
| Explorer services | https://explorer.testnet.kriptonyx.com/api | Accounts, watchlists, DeFi data | Bearer JWT |
Every endpoint, live
The API reference below lists every endpoint of the chain data API, with a Try it out button that calls the testnet from this page.
Choosing
Reading chain state. Use the chain data API for anything historical — it is indexed, so a query that would take thousands of JSON-RPC calls takes one. Use JSON-RPC directly for current state and for eth_call.
Signing your own transactions. Use JSON-RPC with ethers.js or viem. Your users keep their keys. This is the right default for anything user-facing.
Letting the platform hold keys. Use the Platform REST API. It stores an encrypted key per wallet and signs for you, authenticated by a password. Convenient for server-side integrations where there is no user wallet to prompt.
Moving assets across chains. Use the bridge API.
Reacting to events. Use WebSocket in a browser and webhooks on a server.
Common conventions
All five APIs speak JSON over HTTPS. Response shapes differ — the chain data API returns resources directly, the Platform REST API wraps everything in a { success, data } envelope — so see Errors and conventions.
Rate limits
The chain data API and the bridge API are not rate limited for normal use. The explorer services API limits authentication and public forms; see Explorer services API.
Be reasonable regardless: paginate rather than requesting everything, and cache what does not change.
API reference
The chain data API is a Blockscout instance, and it answers in four styles. This is the reference Blockscout publishes at api.testnet.kriptonyx.com/api-docs, cut down to what works on this network: every endpoint below was called against the testnet, and the ones that did not answer were left out.
| Style | Endpoint | Use it for |
|---|---|---|
| REST API | https://api.testnet.kriptonyx.com/api/v2 | New integrations: resources, pagination, full JSON |
| Stats API | https://api.testnet.kriptonyx.com/api/v1 | Network counters and time-series charts |
| ETH RPC API | https://api.testnet.kriptonyx.com/api/eth-rpc | Standard eth_* JSON-RPC calls |
| RPC API endpoints | https://api.testnet.kriptonyx.com/api | Etherscan-style ?module=&action= calls |
All four are public: no key, and cross-origin requests are allowed, so a browser app can call them directly.
REST API
The main API, with 52 endpoints in 12 groups. Open a group, pick an endpoint and choose Try it out. The fields are pre-filled with a real KUSD transfer, its block, the address that sent it, the KUSD token and a verified contract, so Execute returns live data straight away.
Loading the reference…
Endpoints in Blockscout's spec that are not listed here
| Endpoint | Why |
|---|---|
GET /transactions/{hash}/summary | The transaction interpretation service is not enabled on this network; the call returns 403. |
GET /api/v1/celestia/blob | For chains that post data to Celestia. KriptoNyx does not. |
GET /api/v1/celestia/l2BatchMetadata | Same. |
GET /health | The Celestia service's health check; not routed here. |
Stats API
Counters and daily charts computed by Blockscout's stats service: the numbers behind the explorer's charts. GET /api/v1/lines lists every chart, and its IDs go into GET /api/v1/lines/{name}.
Loading the reference…
Endpoints in the stats service's spec that are not listed here
| Endpoint | Why |
|---|---|
POST /api/v1/charts/batch-update | Operator only: it needs the service's API key. |
GET /api/v1/update-status | Not routed to the stats service on this network. |
GET /api/v1/pages/interchain/main | For interchain indexers; every value is null here. |
GET /api/v1/pages/multichain/main | For multichain indexers; every value is null here. |
GET /health | Not routed to the stats service on this network. |
ETH RPC API
JSON-RPC 2.0 over POST, in exactly the format an Ethereum node uses, so ethers.js, viem and web3.js work against it unchanged.
bash
curl -s https://api.testnet.kriptonyx.com/api/eth-rpc \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'json
{ "jsonrpc": "2.0", "result": "0x5ee57e", "id": 1 }| Method | Returns |
|---|---|
eth_blockNumber | The latest block number |
eth_chainId | 0xbc1 (3009) |
eth_gasPrice | The current gas price |
eth_maxPriorityFeePerGas | The suggested priority fee |
eth_getBalance | An address's KNYX balance |
eth_getTransactionCount | An address's nonce |
eth_getCode | A contract's bytecode |
eth_getStorageAt | One storage slot of a contract |
eth_getBlockByNumber | A block, by number or tag |
eth_getBlockByHash | A block, by hash |
eth_getTransactionByHash | A transaction |
eth_getTransactionReceipt | A transaction's receipt |
eth_getLogs | Event logs. Needs an address or topics filter. |
eth_call | The result of a read-only contract call |
eth_estimateGas | The gas a transaction would use |
eth_sendRawTransaction | Submits a signed transaction |
Any other method returns "Action not found.". For the node's full JSON-RPC interface, use https://rpc.testnet.kriptonyx.com, as in Connect to the network.
RPC API endpoints
An Etherscan-compatible API, for tools and scripts written against Etherscan. Every call is a GET (POST also works) with the module and action in the query string:
bash
curl -s "https://api.testnet.kriptonyx.com/api?module=account&action=balance&address=0x0Ff60aa4c32c76f44a82d7B7B80cDbAEC558D629"json
{ "message": "OK", "result": "0", "status": "1" }status is "1" when there is a result and "0" when there is not. An empty list comes back as "0" with a message such as "No transactions found", not as an error, so check message before treating "0" as a failure.
account
| Action | Parameters | Returns |
|---|---|---|
balance | address | KNYX balance, in wei |
balancemulti | address (comma-separated) | Balances of several addresses |
txlist | address, optional startblock endblock page offset sort | Transactions |
txlistinternal | address or txhash | Internal transactions |
tokentx | address, optional contractaddress | ERC-20 transfers |
tokennfttx | address | ERC-721 transfers |
token1155tx | address | ERC-1155 transfers |
tokenbalance | contractaddress, address | One token balance |
tokenlist | address | Every token the address holds |
getminedblocks | address | Blocks the address produced |
pendingtxlist | address | Pending transactions |
listaccounts | optional page offset | Addresses with their balances |
eth_get_balance | address, optional block | Balance, in JSON-RPC form |
block
| Action | Parameters | Returns |
|---|---|---|
getblockreward | blockno | Block producer and reward |
getblocknobytime | timestamp, closest (before or after) | The block nearest a time |
getblockcountdown | blockno | Blocks and estimated seconds until a future block |
eth_block_number | none | The latest block number, in JSON-RPC form |
contract
| Action | Parameters | Returns |
|---|---|---|
listcontracts | optional filter page offset | Contracts, with verified source where there is one |
getabi | address | A verified contract's ABI |
getsourcecode | address | A verified contract's source and compiler settings |
getcontractcreation | contractaddresses | Creator and creation transaction |
logs
| Action | Parameters | Returns |
|---|---|---|
getLogs | fromBlock, toBlock, and address and/or topic0…topic3 | Event logs |
stats
| Action | Parameters | Returns |
|---|---|---|
tokensupply | contractaddress | A token's total supply |
totalfees | date (YYYY-MM-DD) | Fees paid that day, in wei |
coinprice / ethprice | none | KNYX price. null: the testnet coin has no market. |
ethsupply / ethsupplyexchange / coinsupply | none | KNYX supply. 0 on the testnet, which does not track it. |
token
| Action | Parameters | Returns |
|---|---|---|
getToken | contractaddress | Name, symbol, decimals, supply and type |
getTokenHolders | contractaddress, optional page offset | Holders and their balances |
transaction
| Action | Parameters | Returns |
|---|---|---|
gettxinfo | txhash | Transaction details and logs |
gettxreceiptstatus | txhash | 1 success, 0 failure |
getstatus | txhash | Whether the transaction reverted, and why |
token / bridgedTokenList, which Blockscout lists for bridged chains, returns "Unknown action" here.