API REFERENCE v1
Simple Forwarding
A proposed lightweight receiving interface for merchants who want payments forwarded to their own address. Forwarding is not enabled in Coinkun yet.
On this page
#Create Forwarding Address
PlannedThe response pairs a deposit address with a merchant destination. It does not expose an internal account or wallet identifier.
GET
/receiveRequest
- HTTP Method
GET - Content Type
application/json - URL
https://coinkun.com/api/v1/receive
| Parameter | Type | Description | Required |
|---|---|---|---|
method | string | Use create. | Yes |
address | string | Merchant destination for forwarded funds. | Yes |
currency | string | Currency identifier; pass ltc explicitly in these examples. | No |
callback | string | URL-encoded merchant callback URL; place it last in the query. | Yes |
curl --request GET "https://coinkun.com/api/v1/receive" \
--get \
--data-urlencode "method=create" \
--data-urlencode "address=${DESTINATION_ADDRESS}" \
--data-urlencode "currency=ltc" \
--data-urlencode "callback=https://merchant.example/webhooks/coinkun"{
"destination": "LTC_DESTINATION_ADDRESS",
"input_address": "LTC_ADDRESS",
"callback_url": "https://merchant.example/webhooks/coinkun"
}Illustrative example · Replace YOUR_* and ${VARIABLES} with your own values · Never paste real keys into shared documentation.
#Forwarding Policy
PlannedForwarding requires confirmed incoming funds and sufficient value to cover network fees. Very small payments can need deferral instead of an immediate outgoing transaction.
#Response Fields
Planned| Field | Type | Meaning |
|---|---|---|
| destination | string | Merchant receiving address. |
| input_address | string | Deposit address allocated for the payer. |
| callback_url | string | Merchant notification URL. |