логотип

HoneyChain Shop

ShopMy accountReferralAPI
← Back to store

Sell our tokens, earn commission

Plug the shop into your own site or bot. Your customers pay the shop directly — you never handle the money — and you earn a commission on every paid order.

💰 You earn 30% of every paid order

How it works

1

Get your free API key below.

2

Add our tokens to your site or bot using the API.

3

Your customer pays the shop directly — you never touch the money.

4

You earn 30% of every paid order. Check it any time; we pay you out by agreement.

Get your API key

Check your earnings

API reference

Base URL

https://shop.honeychain.online

Auth header — send on every request

Authorization: Bearer <API_KEY>

Endpoints

GET

/api/v1/list

List available tokens, prices and payment options. Token id never changes. Add ?include_paused=1 to also see paused tokens (see "Paused tokens" below). Add ?include_stock=1 to see how many tokens are left (see "Stock" below).

POST

/api/v1/orders

Create an order { id, quantity, address (BUYER's wallet), pay_chain, pay_asset } → returns pay_address & pay_amount. The customer must send EXACTLY pay_amount (it may end in …0001 — that's how the payment is matched to the order). If the token is paused: HTTP 409, code TOKEN_PAUSED.

GET

/api/v1/orders/:id

After the customer pays, poll this until status = delivered — polling confirms the payment and triggers delivery.

GET

/api/v1/stats

Your stats: orders, revenue, commission, full order and payout history.

Example: create an order

curl -X POST https://shop.honeychain.online/api/v1/orders \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"id":"<TOKEN_ID>","quantity":1000,"address":"0x...","pay_chain":"bsc","pay_asset":"USDT"}'

Paused tokens

• When a token is paused (e.g. while its contract is being updated), it disappears from the normal GET /api/v1/list — same as before.

• Add ?include_paused=1 to get paused tokens too. Every token then has status ("available" or "paused") and pause_reason — why it's paused (may be null).

• Creating an order for a paused token returns HTTP 409 with code "TOKEN_PAUSED" and pause_reason. Other codes: "TOKEN_NOT_FOUND" (404) and "OUT_OF_STOCK" (503 — temporarily sold out, being restocked).

• Orders created before the pause are not affected — keep polling them until delivered.

GET /api/v1/list?include_paused=1
{"data": [
  {"id": "…", "symbol": "USDT", …,
   "status": "available", "pause_reason": null},
  {"id": "…", "symbol": "EURC", …,
   "status": "paused",
   "pause_reason": "Contract update"}
], "payment_options": […]}

POST /api/v1/orders  →  HTTP 409
{"error": "Token is paused",
 "code": "TOKEN_PAUSED",
 "pause_reason": "Contract update"}

Stock (tokens left)

• Add ?include_stock=1 to GET /api/v1/list to see how many tokens are left. Every token then has stock — how many whole tokens the shop can deliver right now — and in_stock — true if at least min_order is available.

• Stock is read from the blockchain (the shop's wallet) and refreshed about once a minute. null means it couldn't be checked right now — ordering still works as usual.

• Works together with paused tokens: ?include_paused=1&include_stock=1. Without these parameters the list is exactly the same as before.

GET /api/v1/list?include_stock=1
{"data": [
  {"id": "…", "symbol": "USDT", …,
   "stock": 1250000, "in_stock": true},
  {"id": "…", "symbol": "BUSD", …,
   "stock": 0, "in_stock": false}
], "payment_options": […]}

The customer pays the shop directly — you never touch the money. Tokens are delivered automatically. Your commission is on paid orders only and is settled by agreement.