API ReferenceMerchant API
List static deposit addresses.
Returns a paginated list of static addresses for the authenticated merchant. Supports filtering by currency.
X-API-Key<token>
API key issued by the merchant dashboard. The key's environment (live/test) determines which data the caller can access. Permissions on the key control which endpoints are reachable.
In: header
Query Parameters
currency?string
Filter by currency code.
Length
length <= 20limit?integer
Maximum number of items to return (default 20, max 100).
Default
20Range
1 <= value <= 100offset?integer
Number of items to skip.
Default
0Range
0 <= valueResponse Body
fetch("https://api.halfin.xyz/api/v1/addresses?currency=string&limit=20&offset=0", { method: "GET"}){
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"merchant_id": "500924a8-3f5e-4c00-beb8-2efcde988aea",
"currency": "string",
"environment": "live",
"gate_id": "string",
"address": "string",
"address_tag": "string",
"label": "string",
"total_received": "string",
"invoice_count": 0,
"created_at": "2019-08-24T14:15:22Z"
}
],
"meta": {
"request_id": "string",
"pagination": {
"total": 0,
"limit": 0,
"offset": 0,
"has_more": true
}
}
}{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
]
},
"meta": {
"request_id": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
]
},
"meta": {
"request_id": "string"
}
}{
"error": {
"code": "string",
"message": "string",
"details": [
"string"
]
},
"meta": {
"request_id": "string"
}
}