curl --request GET \
--url https://api.lamarge.trade/v1/fills \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.lamarge.trade/v1/fills', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lamarge.trade/v1/fills"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"take_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role": "taker",
"order_id": "<string>",
"sequence": 123,
"swap_id": "<string>",
"hashlock": "<string>",
"from_venue": "<string>",
"to_venue": "<string>",
"amount_out": "<string>",
"amount_in": "<string>",
"payer": "<string>",
"maker_owner": "<string>",
"maker_recipient": "<string>",
"taker_recipient": "<string>",
"payment_leg": "NONE",
"maker_leg": "NONE",
"state": "RESERVED",
"reason": "<string>",
"pay_by": "2023-11-07T05:31:56Z",
"reveal_by": "2023-11-07T05:31:56Z",
"t1": "2023-11-07T05:31:56Z",
"t2": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"settled_at": "2023-11-07T05:31:56Z",
"margin_move": {
"venue": "<string>",
"amount": "<string>",
"venue_ref": "<string>",
"state": "queued",
"error": "<string>",
"at": "2023-11-07T05:31:56Z"
},
"transactions": [
{
"kind": "permit",
"chain_id": 123,
"hash": "<string>",
"status": "pending",
"error": "<string>",
"at": "2023-11-07T05:31:56Z"
}
],
"payment_destination": "venue",
"maker_destination": "venue"
}
]{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}List my fills
Current fills plus the latest 50 final ones. The master sees its taker and maker fills; a credential sees its identity’s maker fills. More than 1000 selected returns 503 SNAPSHOT_TOO_LARGE; page everything with /v1/fills/history. Credential scope: read.
curl --request GET \
--url https://api.lamarge.trade/v1/fills \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.lamarge.trade/v1/fills', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.lamarge.trade/v1/fills"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"take_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"role": "taker",
"order_id": "<string>",
"sequence": 123,
"swap_id": "<string>",
"hashlock": "<string>",
"from_venue": "<string>",
"to_venue": "<string>",
"amount_out": "<string>",
"amount_in": "<string>",
"payer": "<string>",
"maker_owner": "<string>",
"maker_recipient": "<string>",
"taker_recipient": "<string>",
"payment_leg": "NONE",
"maker_leg": "NONE",
"state": "RESERVED",
"reason": "<string>",
"pay_by": "2023-11-07T05:31:56Z",
"reveal_by": "2023-11-07T05:31:56Z",
"t1": "2023-11-07T05:31:56Z",
"t2": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"settled_at": "2023-11-07T05:31:56Z",
"margin_move": {
"venue": "<string>",
"amount": "<string>",
"venue_ref": "<string>",
"state": "queued",
"error": "<string>",
"at": "2023-11-07T05:31:56Z"
},
"transactions": [
{
"kind": "permit",
"chain_id": 123,
"hash": "<string>",
"status": "pending",
"error": "<string>",
"at": "2023-11-07T05:31:56Z"
}
],
"payment_destination": "venue",
"maker_destination": "venue"
}
]{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"retryable": true
}
}Authorizations
Master session from POST /v1/auth/verify. Revocable; expires after seven days by default. Required for financial operations.
Response
The fills.
taker, maker ^0x[0-9a-fA-F]{64}$Quote sequence the fill was accepted under.
Shared by both locks.
^0x[0-9a-fA-F]{64}$sha256 of the fill's secret, which LaMarge keeps until the taker's claim.
^0x[0-9a-fA-F]{64}$A venue id from GET /v1/venues.
A venue id from GET /v1/venues.
What the taker receives on to_venue.
^[0-9]{1,78}$What the taker pays on from_venue, ceil(amount_out × receive / supply).
^[0-9]{1,78}$The taker's linked address on from_venue.
^0x[0-9a-fA-F]{40}$The order's owner in the to_venue escrow.
^0x[0-9a-fA-F]{40}$Where the maker receives payment, from the quote.
^0x[0-9a-fA-F]{40}$The taker's linked address on to_venue.
^0x[0-9a-fA-F]{40}$The taker's lock on the from_venue chain.
NONE, LOCKED, CLAIMED, REFUNDED The slice of the order locked on the to_venue chain.
NONE, LOCKED, CLAIMED, REFUNDED, ABANDONED RESERVED, PAID, LOCKED, CLAIMING, SETTLED, EXPIRED, REFUNDING, REFUNDED, MAKER_LOSS, TAKER_LOSS Why the fill expired or stopped.
Payment must lock by then.
LaMarge starts the taker's claim only before then, unless the secret is already public; otherwise both locks are refunded.
Maker lock refund time.
Payment refund time.
RFC 3339 UTC; snapshots and history may keep fractional seconds.
RFC 3339 UTC; snapshots and history may keep fractional seconds.
The take's margin withdrawal, shown to the taker; null for the maker and for new takes.
Show child attributes
Show child attributes
Relayed transactions: permit (a take's first fill), payment, maker_lock, taker_claim, maker_claim, refund_payment, refund_maker.
Show child attributes
Show child attributes
Observed destination of the maker's receipt: venue or escrow; null without proof.
venue, escrow, null Observed destination of the taker's receipt: venue or escrow; null without proof.
venue, escrow, null