@0xmonaco/types 1.1.5-develop.129b2c6 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/README.md +3 -1
  2. package/dist/applications/requests.d.ts +5 -5
  3. package/dist/buildercodes/index.d.ts +11 -13
  4. package/dist/buildercodes/responses.d.ts +0 -1
  5. package/dist/buildercodes/responses.js +0 -10
  6. package/dist/index.d.ts +0 -1
  7. package/dist/index.js +0 -1
  8. package/dist/margin-accounts/index.d.ts +2 -7
  9. package/dist/market/index.d.ts +20 -0
  10. package/dist/profile/index.d.ts +17 -10
  11. package/dist/rfq/responses.d.ts +0 -36
  12. package/dist/rfq/responses.js +0 -29
  13. package/dist/sdk/index.d.ts +1 -4
  14. package/dist/trading/index.d.ts +2 -4
  15. package/dist/trading/orders.d.ts +0 -11
  16. package/dist/trading/responses.d.ts +2 -2
  17. package/dist/validation/margin-accounts.d.ts +2 -2
  18. package/dist/validation/margin-accounts.js +5 -5
  19. package/dist/validation/trading.d.ts +0 -15
  20. package/dist/validation/trading.js +42 -34
  21. package/dist/websocket/base.d.ts +10 -40
  22. package/dist/websocket/client.d.ts +4 -32
  23. package/dist/websocket/events/orderbook-events.d.ts +1 -41
  24. package/dist/websocket/events/rfq-events.d.ts +1 -30
  25. package/dist/websocket/events/trade-events.d.ts +0 -31
  26. package/dist/websocket/index.d.ts +0 -1
  27. package/dist/websocket/index.js +0 -1
  28. package/dist/websocket/snapshots.d.ts +1 -23
  29. package/dist/wire/operations.d.ts +1 -1
  30. package/dist/wire/operations.js +0 -16
  31. package/dist/wire/schema.d.ts +295 -2308
  32. package/package.json +2 -2
  33. package/dist/analytics/builders.d.ts +0 -131
  34. package/dist/analytics/builders.js +0 -11
  35. package/dist/analytics/index.d.ts +0 -151
  36. package/dist/analytics/index.js +0 -27
  37. package/dist/analytics/wallets.d.ts +0 -193
  38. package/dist/analytics/wallets.js +0 -16
  39. package/dist/websocket/depth.d.ts +0 -142
  40. package/dist/websocket/depth.js +0 -13
@@ -434,329 +434,6 @@ export interface paths {
434
434
  patch?: never;
435
435
  trace?: never;
436
436
  };
437
- "/api/v1/analytics/builder-leaderboard": {
438
- parameters: {
439
- query?: never;
440
- header?: never;
441
- path?: never;
442
- cookie?: never;
443
- };
444
- /**
445
- * Builder leaderboard
446
- * @description Displayed builders ranked by volume over a window, largest first.
447
- */
448
- get: operations["list_builder_leaderboard"];
449
- put?: never;
450
- post?: never;
451
- delete?: never;
452
- options?: never;
453
- head?: never;
454
- patch?: never;
455
- trace?: never;
456
- };
457
- "/api/v1/analytics/builders": {
458
- parameters: {
459
- query?: never;
460
- header?: never;
461
- path?: never;
462
- cookie?: never;
463
- };
464
- /**
465
- * Builders
466
- * @description Every displayed builder, by name. Archived applications are left out.
467
- */
468
- get: operations["list_builders"];
469
- put?: never;
470
- post?: never;
471
- delete?: never;
472
- options?: never;
473
- head?: never;
474
- patch?: never;
475
- trace?: never;
476
- };
477
- "/api/v1/analytics/builders/{builder}": {
478
- parameters: {
479
- query?: never;
480
- header?: never;
481
- path?: never;
482
- cookie?: never;
483
- };
484
- /**
485
- * Builder
486
- * @description One builder, by application or group uuid, code, or application client id.
487
- */
488
- get: operations["get_builder"];
489
- put?: never;
490
- post?: never;
491
- delete?: never;
492
- options?: never;
493
- head?: never;
494
- patch?: never;
495
- trace?: never;
496
- };
497
- "/api/v1/analytics/builders/{builder}/series": {
498
- parameters: {
499
- query?: never;
500
- header?: never;
501
- path?: never;
502
- cookie?: never;
503
- };
504
- /**
505
- * Builder series
506
- * @description One builder's figures per bucket over a window, oldest first.
507
- */
508
- get: operations["get_builder_series"];
509
- put?: never;
510
- post?: never;
511
- delete?: never;
512
- options?: never;
513
- head?: never;
514
- patch?: never;
515
- trace?: never;
516
- };
517
- "/api/v1/analytics/builders/{builder}/totals": {
518
- parameters: {
519
- query?: never;
520
- header?: never;
521
- path?: never;
522
- cookie?: never;
523
- };
524
- /**
525
- * Builder totals
526
- * @description One builder's figures over a window.
527
- */
528
- get: operations["get_builder_totals"];
529
- put?: never;
530
- post?: never;
531
- delete?: never;
532
- options?: never;
533
- head?: never;
534
- patch?: never;
535
- trace?: never;
536
- };
537
- "/api/v1/analytics/deposits": {
538
- parameters: {
539
- query?: never;
540
- header?: never;
541
- path?: never;
542
- cookie?: never;
543
- };
544
- /**
545
- * Vault deposits
546
- * @description Deposits, newest first.
547
- */
548
- get: operations["list_vault_deposits"];
549
- put?: never;
550
- post?: never;
551
- delete?: never;
552
- options?: never;
553
- head?: never;
554
- patch?: never;
555
- trace?: never;
556
- };
557
- "/api/v1/analytics/markets/volume": {
558
- parameters: {
559
- query?: never;
560
- header?: never;
561
- path?: never;
562
- cookie?: never;
563
- };
564
- /**
565
- * Market volumes
566
- * @description Volume per market over a window, largest first.
567
- */
568
- get: operations["list_market_volumes"];
569
- put?: never;
570
- post?: never;
571
- delete?: never;
572
- options?: never;
573
- head?: never;
574
- patch?: never;
575
- trace?: never;
576
- };
577
- "/api/v1/analytics/protocol/series": {
578
- parameters: {
579
- query?: never;
580
- header?: never;
581
- path?: never;
582
- cookie?: never;
583
- };
584
- /**
585
- * Protocol series
586
- * @description Protocol figures per bucket over a window, oldest first.
587
- */
588
- get: operations["get_protocol_series"];
589
- put?: never;
590
- post?: never;
591
- delete?: never;
592
- options?: never;
593
- head?: never;
594
- patch?: never;
595
- trace?: never;
596
- };
597
- "/api/v1/analytics/protocol/totals": {
598
- parameters: {
599
- query?: never;
600
- header?: never;
601
- path?: never;
602
- cookie?: never;
603
- };
604
- /**
605
- * Protocol totals
606
- * @description Protocol totals over a window.
607
- */
608
- get: operations["get_protocol_totals"];
609
- put?: never;
610
- post?: never;
611
- delete?: never;
612
- options?: never;
613
- head?: never;
614
- patch?: never;
615
- trace?: never;
616
- };
617
- "/api/v1/analytics/tokens": {
618
- parameters: {
619
- query?: never;
620
- header?: never;
621
- path?: never;
622
- cookie?: never;
623
- };
624
- /**
625
- * Token custody
626
- * @description Custody per token and the total value locked.
627
- */
628
- get: operations["list_token_custody"];
629
- put?: never;
630
- post?: never;
631
- delete?: never;
632
- options?: never;
633
- head?: never;
634
- patch?: never;
635
- trace?: never;
636
- };
637
- "/api/v1/analytics/tokens/{token}": {
638
- parameters: {
639
- query?: never;
640
- header?: never;
641
- path?: never;
642
- cookie?: never;
643
- };
644
- /**
645
- * Token custody detail
646
- * @description One token's custody, by symbol, asset UUID or contract address.
647
- */
648
- get: operations["get_token_custody"];
649
- put?: never;
650
- post?: never;
651
- delete?: never;
652
- options?: never;
653
- head?: never;
654
- patch?: never;
655
- trace?: never;
656
- };
657
- "/api/v1/analytics/treasury/net-fees": {
658
- parameters: {
659
- query?: never;
660
- header?: never;
661
- path?: never;
662
- cookie?: never;
663
- };
664
- /**
665
- * Treasury net fees
666
- * @description The treasury's all-time net fees.
667
- */
668
- get: operations["get_treasury_net_fees"];
669
- put?: never;
670
- post?: never;
671
- delete?: never;
672
- options?: never;
673
- head?: never;
674
- patch?: never;
675
- trace?: never;
676
- };
677
- "/api/v1/analytics/wallet-leaderboard": {
678
- parameters: {
679
- query?: never;
680
- header?: never;
681
- path?: never;
682
- cookie?: never;
683
- };
684
- /**
685
- * Wallet leaderboard
686
- * @description Wallets ranked by all-time taker volume, largest first. One row per
687
- * wallet, every builder counted.
688
- */
689
- get: operations["list_wallet_leaderboard"];
690
- put?: never;
691
- post?: never;
692
- delete?: never;
693
- options?: never;
694
- head?: never;
695
- patch?: never;
696
- trace?: never;
697
- };
698
- "/api/v1/analytics/wallets/{wallet}": {
699
- parameters: {
700
- query?: never;
701
- header?: never;
702
- path?: never;
703
- cookie?: never;
704
- };
705
- /**
706
- * Wallet summary
707
- * @description One wallet's all-time taker volume and trades, per displayed builder,
708
- * and its liquidation count. A wallet that never traded answers with
709
- * empty figures.
710
- */
711
- get: operations["get_wallet_summary"];
712
- put?: never;
713
- post?: never;
714
- delete?: never;
715
- options?: never;
716
- head?: never;
717
- patch?: never;
718
- trace?: never;
719
- };
720
- "/api/v1/analytics/wallets/{wallet}/liquidations": {
721
- parameters: {
722
- query?: never;
723
- header?: never;
724
- path?: never;
725
- cookie?: never;
726
- };
727
- /**
728
- * Wallet liquidations
729
- * @description One wallet's liquidation events across every market, newest first.
730
- */
731
- get: operations["list_wallet_liquidations"];
732
- put?: never;
733
- post?: never;
734
- delete?: never;
735
- options?: never;
736
- head?: never;
737
- patch?: never;
738
- trace?: never;
739
- };
740
- "/api/v1/analytics/withdrawals": {
741
- parameters: {
742
- query?: never;
743
- header?: never;
744
- path?: never;
745
- cookie?: never;
746
- };
747
- /**
748
- * Vault withdrawals
749
- * @description Withdrawals, newest first.
750
- */
751
- get: operations["list_vault_withdrawals"];
752
- put?: never;
753
- post?: never;
754
- delete?: never;
755
- options?: never;
756
- head?: never;
757
- patch?: never;
758
- trace?: never;
759
- };
760
437
  "/api/v1/applications/balances": {
761
438
  parameters: {
762
439
  query?: never;
@@ -1261,25 +938,12 @@ export interface paths {
1261
938
  *
1262
939
  * A claim can also fail as **HTTP 503** / **UNAVAILABLE** when the matching
1263
940
  * engine is unreachable, restarting, or slow to answer. Treat that as an
1264
- * UNKNOWN outcome, NOT a rejection: the request is admitted to the sequencer
941
+ * UNKNOWN outcome, NOT a rejection. The request is admitted to the sequencer
1265
942
  * before its reply is sent, so a claim that timed out in transit may still
1266
- * commit.
1267
- *
1268
- * Send an `idempotencyKey` to make that retry safe. Retrying the same key
1269
- * and request within 15 minutes of the original acceptance returns the
1270
- * original claim's result without moving money again, including when the
1271
- * original is still queued, so the retry waits for it. The same key with a
1272
- * different request, or a key already used on another endpoint, is refused
1273
- * with `IDEMPOTENCY_KEY_CONFLICT` (**HTTP 409** / **ALREADY_EXISTS**).
1274
- * `ORDER_SUBMISSION_UNAVAILABLE` and `ORDER_SUBMISSION_CAPACITY_EXCEEDED`
1275
- * (**HTTP 503** / **UNAVAILABLE**) mean the outcome is held but cannot be
1276
- * read, or no new key can be accepted: retry with the same key and request.
1277
- * The window does not extend on retries; after it the key claims again.
1278
- *
1279
- * Without a key, a blind retry can claim a SECOND time.
1280
- * Do NOT retry automatically, and do not settle it with a balance read: an
1281
- * admitted claim can still be sitting in the sequencer queue when the
1282
- * balance is read, so an unchanged balance does not prove the claim will
943
+ * commit, and there is no idempotency key — a blind retry can claim a SECOND
944
+ * time. Do NOT retry automatically, and do not settle it with a balance
945
+ * read: an admitted claim can still be sitting in the sequencer queue when
946
+ * the balance is read, so an unchanged balance does not prove the claim will
1283
947
  * not commit. Treat the claim as PENDING rather than failed, re-check once
1284
948
  * the engine is healthy again, and reconcile before issuing another claim.
1285
949
  *
@@ -2880,10 +2544,9 @@ export interface paths {
2880
2544
  * Orderbook Snapshot
2881
2545
  * @description Orderbook Snapshot
2882
2546
  *
2883
- * Get a point-in-time orderbook snapshot for a trading pair: the top bid
2884
- * and ask price levels, up to 1000 per side. Above 100 levels the snapshot
2885
- * is read from the market-data service and carries bookSeq. This is a
2886
- * public endpoint that does not require authentication.
2547
+ * Get the complete orderbook snapshot for a trading pair showing all bids
2548
+ * and asks with their price levels. This is a public endpoint that does
2549
+ * not require authentication.
2887
2550
  */
2888
2551
  get: operations["get_orderbook_snapshot"];
2889
2552
  put?: never;
@@ -4384,27 +4047,6 @@ export interface components {
4384
4047
  */
4385
4048
  copyAccountAvailable?: string | null;
4386
4049
  };
4387
- /** @description The window a response covers, as the server resolved it. */
4388
- AnalyticsWindow: {
4389
- /**
4390
- * Format: int64
4391
- * @description Window start as Unix milliseconds. Buckets starting at or after it count.
4392
- * @example 1762041600000
4393
- */
4394
- startTime?: number | null;
4395
- /**
4396
- * Format: int64
4397
- * @description Window end as Unix milliseconds. Buckets starting at or before it count, so the bucket holding it (usually partial) is included.
4398
- * @example 1762128000000
4399
- */
4400
- endTime?: number | null;
4401
- /**
4402
- * @description Bucket size the window is counted in: hour up to 2.5 days, day up to 45 days, week beyond. UTC; weeks start Monday.
4403
- * @example hour
4404
- * @enum {string|null}
4405
- */
4406
- granularity?: "hour" | "day" | "week" | null;
4407
- };
4408
4050
  AppUser: {
4409
4051
  /**
4410
4052
  * Format: uuid
@@ -4823,7 +4465,7 @@ export interface components {
4823
4465
  */
4824
4466
  quantity: string;
4825
4467
  /**
4826
- * @description Trading mode: SPOT or MARGIN. Omitted, it takes the trading pair market type
4468
+ * @description Trading mode: SPOT or MARGIN (default: SPOT)
4827
4469
  * @example SPOT
4828
4470
  */
4829
4471
  tradingMode?: string | null;
@@ -4883,8 +4525,8 @@ export interface components {
4883
4525
  */
4884
4526
  reduceOnly?: boolean | null;
4885
4527
  /**
4886
- * @description Sub-account key of the margin account the order trades on, like marginAccountId (`default` is the default margin account). Refused when it is not a valid sub-account key or disagrees with marginAccountId; a key naming none of the caller's open sub-accounts is refused by the matching engine.
4887
- * @example hedge
4528
+ * @description Strategy key used to group risk buckets for delegated/margin orders
4529
+ * @example my-strategy
4888
4530
  */
4889
4531
  strategyKey?: string | null;
4890
4532
  /**
@@ -5038,100 +4680,6 @@ export interface components {
5038
4680
  matchResult?: components["schemas"]["MatchResult"];
5039
4681
  error?: components["schemas"]["BatchReplaceError"];
5040
4682
  };
5041
- /** @description A builder's identity: an application, or a display group of applications. */
5042
- Builder: {
5043
- /**
5044
- * Format: uuid
5045
- * @description Application UUID, or display group UUID when kind is group
5046
- * @example 789e0123-e45b-12d3-a456-426614174000
5047
- */
5048
- id?: string | null;
5049
- /**
5050
- * @description application: one application. group: a display group of several applications shown as one builder.
5051
- * @example application
5052
- * @enum {string|null}
5053
- */
5054
- kind?: "application" | "group" | null;
5055
- /**
5056
- * @description Display name
5057
- * @example Monaco SDK
5058
- */
5059
- name?: string | null;
5060
- /**
5061
- * @description Short display code, if set; also a lookup key
5062
- * @example MON
5063
- */
5064
- code?: string | null;
5065
- /**
5066
- * @description Display color, #rrggbb or #rrggbbaa, if set
5067
- * @example #112233
5068
- */
5069
- color?: string | null;
5070
- /**
5071
- * @description Shown as verified
5072
- * @example true
5073
- */
5074
- verified?: boolean | null;
5075
- /**
5076
- * @description The display group an application is shown under on the directory and the
5077
- * leaderboard, when it has one. Unset for a group and for an ungrouped
5078
- * application.
5079
- */
5080
- group?: components["schemas"]["BuilderGroupRef"] | null;
5081
- /**
5082
- * @description The application itself (kind application), or the group's displayed
5083
- * applications (kind group). Builder attribution on other responses (wallet
5084
- * summaries, deposit and withdrawal feeds) may send this empty: there the
5085
- * builder is an identity only.
5086
- */
5087
- applications?: components["schemas"]["BuilderApplication"][] | null;
5088
- };
5089
- /** @description One application behind a builder. */
5090
- BuilderApplication: {
5091
- /**
5092
- * Format: uuid
5093
- * @description Application UUID
5094
- * @example 789e0123-e45b-12d3-a456-426614174000
5095
- */
5096
- id?: string | null;
5097
- /**
5098
- * @description Application name
5099
- * @example Monaco SDK
5100
- */
5101
- name?: string | null;
5102
- /**
5103
- * @description On-chain client id the application's deposits carry
5104
- * @example 688a21440e304c06b935f743dae88278
5105
- */
5106
- clientId?: string | null;
5107
- /**
5108
- * @description Whether the application can place new orders. An inactive builder keeps the volume it routed.
5109
- * @example true
5110
- */
5111
- active?: boolean | null;
5112
- /**
5113
- * @description Whether the application is archived. Archived applications are left out of the builder directory but keep their figures.
5114
- * @example false
5115
- */
5116
- archived?: boolean | null;
5117
- /**
5118
- * Format: int32
5119
- * @description Taker add-on the application charges, in basis points
5120
- * @example 0
5121
- */
5122
- additionalTakerFeeBps?: number | null;
5123
- /**
5124
- * Format: int32
5125
- * @description Maker add-on the application charges, in basis points
5126
- * @example 0
5127
- */
5128
- additionalMakerFeeBps?: number | null;
5129
- /**
5130
- * @description Whether this is the exchange's default application: the one a sign-in that names no client id is placed under
5131
- * @example false
5132
- */
5133
- isDefault?: boolean | null;
5134
- };
5135
4683
  BuilderFeeChange: {
5136
4684
  /**
5137
4685
  * @description Who made the change: `BUILDER` (this application's payout wallet) or `ADMIN` (Monaco, on the application's behalf).
@@ -5174,142 +4722,6 @@ export interface components {
5174
4722
  */
5175
4723
  newMakerBps?: number | null;
5176
4724
  };
5177
- /** @description A group's identity, for an application shown under a display group. */
5178
- BuilderGroupRef: {
5179
- /**
5180
- * Format: uuid
5181
- * @description Display group UUID; GET /api/v1/analytics/builders/{id} answers the group
5182
- * @example 5b1e2c9a-0f6d-4e8b-9a71-3c2d4e5f6a7b
5183
- */
5184
- id?: string | null;
5185
- /**
5186
- * @description The group's display name
5187
- * @example Monaco
5188
- */
5189
- name?: string | null;
5190
- /**
5191
- * @description The group's display code, if it has one
5192
- * @example MON
5193
- */
5194
- code?: string | null;
5195
- };
5196
- BuilderLeaderboardRow: {
5197
- builder?: components["schemas"]["Builder"];
5198
- /**
5199
- * @description Taker volume in USD (USDC 1:1) of the trades the builder's applications took
5200
- * @example 25000
5201
- */
5202
- volumeUsd?: string | null;
5203
- /**
5204
- * @description The spot part of volumeUsd
5205
- * @example 0
5206
- */
5207
- spotVolumeUsd?: string | null;
5208
- /**
5209
- * @description The perpetual (margin) part of volumeUsd
5210
- * @example 25000
5211
- */
5212
- perpVolumeUsd?: string | null;
5213
- /**
5214
- * Format: int64
5215
- * @description Trades the builder's applications took
5216
- * @example 120
5217
- */
5218
- tradesCount?: number | null;
5219
- /**
5220
- * @description The builder's own fee revenue in USD: taker add-ons on the trades it took plus maker add-ons on the trades it made. Never the protocol taker fee.
5221
- * @example 12.5
5222
- */
5223
- feesUsd?: string | null;
5224
- /**
5225
- * @description The taker add-on part of feesUsd
5226
- * @example 10
5227
- */
5228
- takerFeesUsd?: string | null;
5229
- /**
5230
- * @description The maker add-on part of feesUsd, earned on trades the builder's applications made, whoever took them
5231
- * @example 2.5
5232
- */
5233
- makerFeesUsd?: string | null;
5234
- /**
5235
- * Format: int64
5236
- * @description Wallets whose first trade through one of the builder's applications fell in the window, counted once per (application, wallet)
5237
- * @example 4
5238
- */
5239
- newTraders?: number | null;
5240
- /**
5241
- * Format: int64
5242
- * @description Distinct taker wallets that traded through the builder in the window, each once however many buckets or applications it traded in. With window=all, every wallet that ever traded through it. Null for a window counted in hours that starts before the 90 days its hourly sets are kept.
5243
- * @example 18
5244
- */
5245
- activeTakers?: number | null;
5246
- /**
5247
- * @description USDC deposited through the builder's applications in the window, in USD (1:1). Other tokens are unvalued and not counted.
5248
- * @example 15000
5249
- */
5250
- depositsUsd?: string | null;
5251
- };
5252
- BuilderSeriesPoint: {
5253
- /**
5254
- * Format: int64
5255
- * @description Bucket start as Unix milliseconds (UTC; weeks start Monday)
5256
- * @example 1762038000000
5257
- */
5258
- bucketStart?: number | null;
5259
- /**
5260
- * @description Taker volume in USD (USDC 1:1) of the trades the builder's applications took
5261
- * @example 1200
5262
- */
5263
- volumeUsd?: string | null;
5264
- /**
5265
- * @description The spot part of volumeUsd
5266
- * @example 0
5267
- */
5268
- spotVolumeUsd?: string | null;
5269
- /**
5270
- * @description The perpetual (margin) part of volumeUsd
5271
- * @example 1200
5272
- */
5273
- perpVolumeUsd?: string | null;
5274
- /**
5275
- * Format: int64
5276
- * @description Trades the builder's applications took
5277
- * @example 120
5278
- */
5279
- tradesCount?: number | null;
5280
- /**
5281
- * @description The builder's own fee revenue in USD: taker add-ons on the trades it took plus maker add-ons on the trades it made. Never the protocol taker fee.
5282
- * @example 12.5
5283
- */
5284
- feesUsd?: string | null;
5285
- /**
5286
- * @description The taker add-on part of feesUsd
5287
- * @example 10
5288
- */
5289
- takerFeesUsd?: string | null;
5290
- /**
5291
- * @description The maker add-on part of feesUsd, earned on trades the builder's applications made, whoever took them
5292
- * @example 2.5
5293
- */
5294
- makerFeesUsd?: string | null;
5295
- /**
5296
- * Format: int64
5297
- * @description Distinct taker wallets that traded through the builder in the bucket
5298
- * @example 3
5299
- */
5300
- activeTakers?: number | null;
5301
- /**
5302
- * Format: int64
5303
- * @description Wallets whose first trade through one of the builder's applications fell in the bucket, counted once per (application, wallet)
5304
- * @example 1
5305
- */
5306
- newTraders?: number | null;
5307
- /**
5308
- * @description USDC deposited through the builder's applications in the bucket, in USD (1:1)
5309
- * @example 500
5310
- */
5311
- depositsUsd?: string | null;
5312
- };
5313
4725
  BuildercodePayout: {
5314
4726
  /**
5315
4727
  * Format: uuid
@@ -5580,7 +4992,7 @@ export interface components {
5580
4992
  */
5581
4993
  clientId?: string | null;
5582
4994
  /**
5583
- * @description Optional EVM chain ID supplied by SDK clients, as a JSON number or a decimal string (for example 1329 or "1329")
4995
+ * @description Optional chain ID supplied by SDK clients
5584
4996
  * @example 1328
5585
4997
  */
5586
4998
  chainId?: string | null;
@@ -5643,11 +5055,6 @@ export interface components {
5643
5055
  * @example 1000000
5644
5056
  */
5645
5057
  amount: string;
5646
- /**
5647
- * @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original claim's result without moving money again; its payoutBalance and tradingBalance are the original claim's. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key claims again. Generate a fresh key for each intended claim and keep it across retries of that claim.
5648
- * @example claim-2026-10-28-001
5649
- */
5650
- idempotencyKey?: string | null;
5651
5058
  };
5652
5059
  ClaimBuildercodeRewardsResponse: {
5653
5060
  /**
@@ -5915,7 +5322,7 @@ export interface components {
5915
5322
  */
5916
5323
  quantity: string;
5917
5324
  /**
5918
- * @description Trading mode: SPOT or MARGIN. Omitted, it takes the trading pair market type
5325
+ * @description Trading mode: SPOT or MARGIN (default: SPOT)
5919
5326
  * @example SPOT
5920
5327
  */
5921
5328
  tradingMode?: string | null;
@@ -5977,8 +5384,8 @@ export interface components {
5977
5384
  takeProfit?: components["schemas"]["ParentTpSlLeg"];
5978
5385
  stopLoss?: components["schemas"]["ParentTpSlLeg"];
5979
5386
  /**
5980
- * @description Sub-account key of the margin account the order trades on, like marginAccountId (`default` is the default margin account). Refused when it is not a valid sub-account key or disagrees with marginAccountId; a key naming none of the caller's open sub-accounts is refused by the matching engine.
5981
- * @example hedge
5387
+ * @description Strategy key used to group risk buckets for delegated/margin orders
5388
+ * @example my-strategy
5982
5389
  */
5983
5390
  strategyKey?: string | null;
5984
5391
  /**
@@ -6046,7 +5453,7 @@ export interface components {
6046
5453
  * @description Resolved isolated risk bucket UUID for risk-bucket-scoped margin orders
6047
5454
  */
6048
5455
  riskBucketId?: string | null;
6049
- /** @description The request's strategyKey (the sub-account key), echoed */
5456
+ /** @description Client strategy key carried for compatibility */
6050
5457
  strategyKey?: string | null;
6051
5458
  /**
6052
5459
  * Format: uuid
@@ -6159,7 +5566,7 @@ export interface components {
6159
5566
  */
6160
5567
  reduceOnly?: boolean | null;
6161
5568
  /**
6162
- * @description Trading mode: SPOT or MARGIN. Omitted, it takes the trading pair market type. A mode that does not match the pair is rejected
5569
+ * @description Trading mode: SPOT or MARGIN (default: SPOT)
6163
5570
  * @example SPOT
6164
5571
  */
6165
5572
  tradingMode?: string | null;
@@ -6187,8 +5594,8 @@ export interface components {
6187
5594
  */
6188
5595
  leverage?: string | null;
6189
5596
  /**
6190
- * @description Sub-account key of the margin account the order trades on, like marginAccountId (`default` is the default margin account). Refused when it is not a valid sub-account key or disagrees with marginAccountId; a key naming none of the caller's open sub-accounts is refused by the matching engine.
6191
- * @example hedge
5597
+ * @description Strategy key used to group risk buckets for margin orders
5598
+ * @example my-strategy
6192
5599
  */
6193
5600
  strategyKey?: string | null;
6194
5601
  /**
@@ -6769,75 +6176,6 @@ export interface components {
6769
6176
  */
6770
6177
  nextPageToken?: string | null;
6771
6178
  };
6772
- GetBuilderResponse: {
6773
- builder?: components["schemas"]["Builder"];
6774
- };
6775
- GetBuilderSeriesResponse: {
6776
- window?: components["schemas"]["AnalyticsWindow"];
6777
- builder?: components["schemas"]["Builder"];
6778
- /**
6779
- * @description One point per bucket of the window, oldest first. A bucket without
6780
- * trades is present with zeros.
6781
- */
6782
- points?: components["schemas"]["BuilderSeriesPoint"][] | null;
6783
- };
6784
- GetBuilderTotalsResponse: {
6785
- window?: components["schemas"]["AnalyticsWindow"];
6786
- builder?: components["schemas"]["Builder"];
6787
- /**
6788
- * @description Taker volume in USD (USDC 1:1) of the trades the builder's applications took
6789
- * @example 25000
6790
- */
6791
- volumeUsd?: string | null;
6792
- /**
6793
- * @description The spot part of volumeUsd
6794
- * @example 0
6795
- */
6796
- spotVolumeUsd?: string | null;
6797
- /**
6798
- * @description The perpetual (margin) part of volumeUsd
6799
- * @example 25000
6800
- */
6801
- perpVolumeUsd?: string | null;
6802
- /**
6803
- * Format: int64
6804
- * @description Trades the builder's applications took
6805
- * @example 120
6806
- */
6807
- tradesCount?: number | null;
6808
- /**
6809
- * @description The builder's own fee revenue in USD: taker add-ons on the trades it took plus maker add-ons on the trades it made. Never the protocol taker fee.
6810
- * @example 12.5
6811
- */
6812
- feesUsd?: string | null;
6813
- /**
6814
- * @description The taker add-on part of feesUsd
6815
- * @example 10
6816
- */
6817
- takerFeesUsd?: string | null;
6818
- /**
6819
- * @description The maker add-on part of feesUsd, earned on trades the builder's applications made, whoever took them
6820
- * @example 2.5
6821
- */
6822
- makerFeesUsd?: string | null;
6823
- /**
6824
- * Format: int64
6825
- * @description Distinct taker wallets that traded through the builder in the window, each once however many buckets or applications it traded in
6826
- * @example 18
6827
- */
6828
- activeTakers?: number | null;
6829
- /**
6830
- * Format: int64
6831
- * @description Wallets whose first trade through one of the builder's applications fell in the window, counted once per (application, wallet)
6832
- * @example 4
6833
- */
6834
- newTraders?: number | null;
6835
- /**
6836
- * @description USDC deposited through the builder's applications in the window, in USD (1:1). Other tokens are unvalued and not counted.
6837
- * @example 15000
6838
- */
6839
- depositsUsd?: string | null;
6840
- };
6841
6179
  GetBuildercodePayoutSummaryResponse: {
6842
6180
  /**
6843
6181
  * Format: int64
@@ -7146,7 +6484,6 @@ export interface components {
7146
6484
  label?: string | null;
7147
6485
  /** Format: uuid */
7148
6486
  tradingPairId?: string | null;
7149
- /** @description The margin account's sub-account key (`default` for the default account). */
7150
6487
  strategyKey?: string | null;
7151
6488
  riskBucketId?: string | null;
7152
6489
  marginMode?: string | null;
@@ -7700,16 +7037,6 @@ export interface components {
7700
7037
  * @example -0.1
7701
7038
  */
7702
7039
  placementMakerFeeBps?: string | null;
7703
- /**
7704
- * Format: uuid
7705
- * @description The RFQ (block trade) this order filled in: set on RFQ orders only (origin RFQ). Read the RFQ itself with GetRfq.
7706
- */
7707
- rfqId?: string | null;
7708
- /**
7709
- * Format: uuid
7710
- * @description Set on a maker's RFQ quote order only: the quote version's internal engine id the order rested for. It is not the public quoteId; the taker's order, which fills from several quotes, carries none.
7711
- */
7712
- rfqQuoteId?: string | null;
7713
7040
  };
7714
7041
  /** @description Orderbook snapshot with token metadata and sequence number. */
7715
7042
  GetOrderbookResponse: {
@@ -7754,7 +7081,7 @@ export interface components {
7754
7081
  quoteToken?: string | null;
7755
7082
  /**
7756
7083
  * Format: uint32
7757
- * @description Legacy orderbook sequence number; not a book version, and its basis can change, so do not compare it across snapshots. Always 0 above 100 levels, where bookSeq versions the snapshot; at 100 or fewer levels no field versions it.
7084
+ * @description Orderbook sequence number
7758
7085
  * @example 12345
7759
7086
  */
7760
7087
  sequenceNumber?: number | null;
@@ -7768,11 +7095,6 @@ export interface components {
7768
7095
  * @example Spot
7769
7096
  */
7770
7097
  tradingMode?: string | null;
7771
- /**
7772
- * @description Durable-log sequence this snapshot is exact as of, as a decimal string. Present only above 100 levels. A point-in-time read and staleness check, not a base for applying WebSocket deltas: for a live local book use the depth WebSocket channel, whose snapshot is the handoff base. A side that returns as many levels as requested may hold more.
7773
- * @example 184467
7774
- */
7775
- bookSeq?: string | null;
7776
7098
  };
7777
7099
  GetPerpMarketConfigResponse: {
7778
7100
  /** Format: uuid */
@@ -8262,6 +7584,20 @@ export interface components {
8262
7584
  * @example 2023-11-13T10:30:00Z
8263
7585
  */
8264
7586
  createdAt?: string | null;
7587
+ /**
7588
+ * Format: int32
7589
+ * @deprecated
7590
+ * @description DEPRECATED: legacy flat maker fee in bps echoed from the trading pair. Does NOT reflect the tiered fee actually charged, which is per-user and fractional. Call GET /api/v1/fees/tier for the caller's real rate. Will be removed in a later release.
7591
+ * @example -1
7592
+ */
7593
+ makerFeeBps?: number | null;
7594
+ /**
7595
+ * Format: int32
7596
+ * @deprecated
7597
+ * @description DEPRECATED: legacy flat taker fee in bps echoed from the trading pair. Does NOT reflect the tiered fee actually charged, which is per-user and fractional. Call GET /api/v1/fees/tier for the caller's real rate. Will be removed in a later release.
7598
+ * @example 5
7599
+ */
7600
+ takerFeeBps?: number | null;
8265
7601
  /**
8266
7602
  * Format: int32
8267
7603
  * @description Additional taker fee in basis points from application
@@ -8275,82 +7611,6 @@ export interface components {
8275
7611
  */
8276
7612
  applicationMakerFeeBps?: number | null;
8277
7613
  };
8278
- GetProtocolSeriesResponse: {
8279
- /** @description The window the series covers */
8280
- window?: components["schemas"]["AnalyticsWindow"] | null;
8281
- /**
8282
- * @description One point per bucket of the window, oldest first. A bucket without
8283
- * trades is present with zeros.
8284
- */
8285
- points?: components["schemas"]["ProtocolSeriesPoint"][] | null;
8286
- };
8287
- GetProtocolTotalsResponse: {
8288
- /** @description The window these totals cover */
8289
- window?: components["schemas"]["AnalyticsWindow"] | null;
8290
- /**
8291
- * @description Taker volume in USD (USDC 1:1) routed by the builders the explorer displays. Trades of hidden builders are not counted.
8292
- * @example 1250000.5
8293
- */
8294
- volumeUsd?: string | null;
8295
- /**
8296
- * @description The spot part of volumeUsd (displayed builders only)
8297
- * @example 250000.5
8298
- */
8299
- spotVolumeUsd?: string | null;
8300
- /**
8301
- * @description The perpetual (margin) part of volumeUsd (displayed builders only)
8302
- * @example 1000000
8303
- */
8304
- perpVolumeUsd?: string | null;
8305
- /**
8306
- * Format: int64
8307
- * @description Trades routed by the displayed builders
8308
- * @example 4210
8309
- */
8310
- tradesCount?: number | null;
8311
- /**
8312
- * @description Protocol taker fees in USD over every trade, all builders included. Excludes builder add-ons and maker fees.
8313
- * @example 625.25
8314
- */
8315
- protocolFeesUsd?: string | null;
8316
- /**
8317
- * Format: int64
8318
- * @description Distinct taker wallets that traded in the window (each wallet once however many buckets it traded in), all builders included
8319
- * @example 312
8320
- */
8321
- activeTakers?: number | null;
8322
- /**
8323
- * Format: int64
8324
- * @description Wallets whose first trade through a builder fell in the window, counted once per (builder, wallet), all builders included
8325
- * @example 27
8326
- */
8327
- newTraders?: number | null;
8328
- /**
8329
- * @description Total value locked in USD at the end of the window (the end of the bucket holding endTime): USDC custody, deposits less initiated withdrawals, valued 1:1. Null when no custody had been folded by then.
8330
- * @example 536172600
8331
- */
8332
- tvlUsd?: string | null;
8333
- /**
8334
- * @description Total value locked in USD at the start of the window (the start of its first bucket). tvlUsd less openingTvlUsd is the window's change. Null when no custody had been folded by then.
8335
- * @example 535000000
8336
- */
8337
- openingTvlUsd?: string | null;
8338
- /**
8339
- * @description USDC deposited in the window, in USD (1:1). Other tokens are unvalued and not counted.
8340
- * @example 1250000
8341
- */
8342
- depositsUsd?: string | null;
8343
- /**
8344
- * @description USDC withdrawals initiated in the window, in USD (1:1). Other tokens are unvalued and not counted.
8345
- * @example 78000
8346
- */
8347
- withdrawalsUsd?: string | null;
8348
- /**
8349
- * @description depositsUsd less withdrawalsUsd; negative when more left than arrived
8350
- * @example 1172000
8351
- */
8352
- netFlowUsd?: string | null;
8353
- };
8354
7614
  GetPulseResponse: {
8355
7615
  /**
8356
7616
  * @description When this snapshot was produced upstream, ISO-8601 UTC; also serves as the response ETag value
@@ -8441,9 +7701,6 @@ export interface components {
8441
7701
  */
8442
7702
  totalPages?: number | null;
8443
7703
  };
8444
- GetTokenCustodyResponse: {
8445
- token?: components["schemas"]["TokenCustody"];
8446
- };
8447
7704
  /** @description A single trade. */
8448
7705
  GetTradeByIdResponse: {
8449
7706
  data?: components["schemas"]["TradeData"];
@@ -8566,20 +7823,6 @@ export interface components {
8566
7823
  GetTradingPairResponse: {
8567
7824
  tradingPair?: components["schemas"]["TradingPairData"];
8568
7825
  };
8569
- /** @description The treasury's all-time net fees. Not windowed: the treasury keeps only running totals. */
8570
- GetTreasuryNetFeesResponse: {
8571
- /**
8572
- * @description All-time net protocol fees in USD (USDC 1:1): the treasury's net protocol fee (taker fees less maker rebates) plus the insurance fund's liquidation fees, less BuilderCodes payouts and TraderCodes rewards. Negative when payouts exceed fees; "0" before any fee. The definition may widen to more fee sources without a contract change.
8573
- * @example 260.37
8574
- */
8575
- netFeesUsd?: string | null;
8576
- /**
8577
- * Format: int64
8578
- * @description When the first counted fee landed, as Unix milliseconds; null before any
8579
- * @example 1750000000000
8580
- */
8581
- countingSince?: number | null;
8582
- };
8583
7826
  GetTwapOrderTcaResponse: {
8584
7827
  /**
8585
7828
  * Format: uuid
@@ -8691,40 +7934,13 @@ export interface components {
8691
7934
  */
8692
7935
  totalCapped?: boolean | null;
8693
7936
  };
8694
- GetWalletSummaryResponse: {
8695
- /**
8696
- * @description The wallet, lowercase
8697
- * @example 0x1234567890abcdef1234567890abcdef12345678
8698
- */
8699
- wallet?: string | null;
8700
- /**
8701
- * @description All-time totals over every builder; null when the wallet never took a
8702
- * trade.
8703
- */
8704
- totals?: components["schemas"]["WalletVolume"] | null;
8705
- /** @description Per displayed builder, largest volume first (ties by builder id). */
8706
- builders?: components["schemas"]["WalletBuilderVolume"][] | null;
8707
- /** @description What hidden builders carried; null when they carried nothing. */
8708
- unattributed?: components["schemas"]["WithheldVolume"] | null;
8709
- /**
8710
- * Format: int64
8711
- * @description Liquidation events of the wallet, every market
8712
- * @example 2
8713
- */
8714
- liquidationsCount?: number | null;
8715
- /**
8716
- * @description Sum of each event's position size times its event-time mark price, in each market's quote units (every market is USDC-quoted today); "0" when never liquidated
8717
- * @example 23852.5625
8718
- */
8719
- liquidationsNotional?: string | null;
8720
- };
8721
- IndexComponent: {
8722
- provider?: string | null;
8723
- price?: string | null;
8724
- weight?: string | null;
8725
- updatedAt?: string | null;
8726
- };
8727
- InitiateWithdrawalRequest: {
7937
+ IndexComponent: {
7938
+ provider?: string | null;
7939
+ price?: string | null;
7940
+ weight?: string | null;
7941
+ updatedAt?: string | null;
7942
+ };
7943
+ InitiateWithdrawalRequest: {
8728
7944
  /**
8729
7945
  * Format: uuid
8730
7946
  * @description UUID of the asset to withdraw
@@ -9295,15 +8511,6 @@ export interface components {
9295
8511
  /** @description Cursor for the next page; empty when there are no more. */
9296
8512
  nextPageToken?: string | null;
9297
8513
  };
9298
- ListBuilderLeaderboardResponse: {
9299
- window?: components["schemas"]["AnalyticsWindow"];
9300
- /**
9301
- * @description Displayed builders with figures in the window, largest volume first
9302
- * (ties by builder id), up to limit. A builder that only earned maker
9303
- * add-ons, or only took deposits, ranks with zero volume.
9304
- */
9305
- rows?: components["schemas"]["BuilderLeaderboardRow"][] | null;
9306
- };
9307
8514
  ListBuildercodePayoutsResponse: {
9308
8515
  /** @description Per-trade credits, newest first. */
9309
8516
  payouts?: components["schemas"]["BuildercodePayout"][] | null;
@@ -9329,13 +8536,6 @@ export interface components {
9329
8536
  */
9330
8537
  nextPageToken?: string | null;
9331
8538
  };
9332
- ListBuildersResponse: {
9333
- /**
9334
- * @description Every displayed builder, by name (case-insensitive) then id. A display
9335
- * group is listed once; its applications are not listed on their own.
9336
- */
9337
- builders?: components["schemas"]["Builder"][] | null;
9338
- };
9339
8539
  ListConditionalOrdersResponse: {
9340
8540
  orders?: components["schemas"]["ConditionalOrder"][] | null;
9341
8541
  /**
@@ -9527,15 +8727,6 @@ export interface components {
9527
8727
  */
9528
8728
  nextPageToken?: string | null;
9529
8729
  };
9530
- ListMarketVolumesResponse: {
9531
- /** @description The window these volumes cover */
9532
- window?: components["schemas"]["AnalyticsWindow"] | null;
9533
- /**
9534
- * @description Markets that traded in the window, largest volume first (ties by
9535
- * trading pair id), up to limit.
9536
- */
9537
- markets?: components["schemas"]["MarketVolume"][] | null;
9538
- };
9539
8730
  ListMyFollowersResponse: {
9540
8731
  followers?: components["schemas"]["Follower"][] | null;
9541
8732
  /** @description Cursor for the next page; empty when there are no more. */
@@ -9652,18 +8843,6 @@ export interface components {
9652
8843
  */
9653
8844
  total?: number | null;
9654
8845
  };
9655
- ListTokenCustodyResponse: {
9656
- /**
9657
- * @description Listed assets by symbol, then tokens with custody flow but no listed
9658
- * asset, by contract address.
9659
- */
9660
- tokens?: components["schemas"]["TokenCustody"][] | null;
9661
- /**
9662
- * @description Total value locked in USD: the custodyUsd of the tokens that count toward it
9663
- * @example 536172600
9664
- */
9665
- tvlUsd?: string | null;
9666
- };
9667
8846
  /** @description One page of the trade feed, newest first. */
9668
8847
  ListTradesResponse: {
9669
8848
  trades?: components["schemas"]["PublicTrade"][] | null;
@@ -9756,44 +8935,6 @@ export interface components {
9756
8935
  */
9757
8936
  nextPageToken?: string | null;
9758
8937
  };
9759
- ListVaultDepositsResponse: {
9760
- deposits?: components["schemas"]["VaultDeposit"][] | null;
9761
- /**
9762
- * Format: uint32
9763
- * @description Number of deposits requested for this page
9764
- * @example 50
9765
- */
9766
- pageSize?: number | null;
9767
- /** @description Opaque cursor for the next page; empty when the page is the end of the ordered result */
9768
- nextPageToken?: string | null;
9769
- };
9770
- ListVaultWithdrawalsResponse: {
9771
- withdrawals?: components["schemas"]["VaultWithdrawal"][] | null;
9772
- /**
9773
- * Format: uint32
9774
- * @description Number of withdrawals requested for this page
9775
- * @example 50
9776
- */
9777
- pageSize?: number | null;
9778
- /** @description Opaque cursor for the next page; empty when the page is the end of the ordered result */
9779
- nextPageToken?: string | null;
9780
- };
9781
- ListWalletLeaderboardResponse: {
9782
- /** @description Wallets by all-time volume, largest first (ties by wallet), up to limit. */
9783
- wallets?: components["schemas"]["WalletVolume"][] | null;
9784
- };
9785
- ListWalletLiquidationsResponse: {
9786
- /** @description The wallet's events in reverse chronological order, every market. */
9787
- events?: components["schemas"]["LiquidationEvent"][] | null;
9788
- /**
9789
- * Format: uint32
9790
- * @description Number of events requested for this page
9791
- * @example 50
9792
- */
9793
- pageSize?: number | null;
9794
- /** @description Opaque cursor for the next page; empty when the page is the end of the ordered result */
9795
- nextPageToken?: string | null;
9796
- };
9797
8938
  ManagedMarketAssignment: {
9798
8939
  launchId?: string | null;
9799
8940
  /** Format: uuid */
@@ -9887,7 +9028,6 @@ export interface components {
9887
9028
  label?: string | null;
9888
9029
  /** Format: uuid */
9889
9030
  tradingPairId?: string | null;
9890
- /** @description The margin account's sub-account key (`default` for the default account). */
9891
9031
  strategyKey?: string | null;
9892
9032
  /** @description Present only for risk-bucket summary rows. */
9893
9033
  riskBucketId?: string | null;
@@ -9984,31 +9124,6 @@ export interface components {
9984
9124
  */
9985
9125
  maxRemovableCollateral?: string | null;
9986
9126
  };
9987
- /** @description One market's figures over the window, all builders included. Resolve the symbol from the trading pairs listing. */
9988
- MarketVolume: {
9989
- /**
9990
- * Format: uuid
9991
- * @description Trading pair UUID
9992
- * @example 123e4567-e89b-12d3-a456-426614174000
9993
- */
9994
- tradingPairId?: string | null;
9995
- /**
9996
- * @description Taker volume in USD over every trade in the market
9997
- * @example 830000
9998
- */
9999
- volumeUsd?: string | null;
10000
- /**
10001
- * @description Protocol taker fees in USD
10002
- * @example 415
10003
- */
10004
- protocolFeesUsd?: string | null;
10005
- /**
10006
- * Format: int64
10007
- * @description Trades in the market
10008
- * @example 2100
10009
- */
10010
- tradesCount?: number | null;
10011
- };
10012
9127
  MatchResult: {
10013
9128
  /**
10014
9129
  * Format: int32
@@ -10932,72 +10047,6 @@ export interface components {
10932
10047
  */
10933
10048
  orderCount?: number | null;
10934
10049
  };
10935
- ProtocolSeriesPoint: {
10936
- /**
10937
- * Format: int64
10938
- * @description Bucket start as Unix milliseconds (UTC; weeks start Monday)
10939
- * @example 1762038000000
10940
- */
10941
- bucketStart?: number | null;
10942
- /**
10943
- * @description Taker volume in USD routed by the displayed builders. Trades of hidden builders are not counted.
10944
- * @example 52000
10945
- */
10946
- volumeUsd?: string | null;
10947
- /**
10948
- * @description The spot part of volumeUsd (displayed builders only)
10949
- * @example 12000
10950
- */
10951
- spotVolumeUsd?: string | null;
10952
- /**
10953
- * @description The perpetual (margin) part of volumeUsd (displayed builders only)
10954
- * @example 40000
10955
- */
10956
- perpVolumeUsd?: string | null;
10957
- /**
10958
- * Format: int64
10959
- * @description Trades routed by the displayed builders
10960
- * @example 180
10961
- */
10962
- tradesCount?: number | null;
10963
- /**
10964
- * @description Protocol taker fees in USD over every trade, all builders included
10965
- * @example 26
10966
- */
10967
- protocolFeesUsd?: string | null;
10968
- /**
10969
- * Format: int64
10970
- * @description Distinct taker wallets that traded in the bucket, all builders included
10971
- * @example 41
10972
- */
10973
- activeTakers?: number | null;
10974
- /**
10975
- * Format: int64
10976
- * @description Wallets whose first trade through a builder fell in the bucket, counted once per (builder, wallet), all builders included
10977
- * @example 3
10978
- */
10979
- newTraders?: number | null;
10980
- /**
10981
- * @description Total value locked in USD at the end of the bucket: USDC custody, deposits less initiated withdrawals, valued 1:1. Carried across buckets without custody movement; null before the first folded custody hour.
10982
- * @example 536172600
10983
- */
10984
- tvlUsd?: string | null;
10985
- /**
10986
- * @description USDC deposited in the bucket, in USD (1:1)
10987
- * @example 52000
10988
- */
10989
- depositsUsd?: string | null;
10990
- /**
10991
- * @description USDC withdrawals initiated in the bucket, in USD (1:1)
10992
- * @example 3000
10993
- */
10994
- withdrawalsUsd?: string | null;
10995
- /**
10996
- * @description depositsUsd less withdrawalsUsd; negative when more left than arrived
10997
- * @example 49000
10998
- */
10999
- netFlowUsd?: string | null;
11000
- };
11001
10050
  PublicHealthCheckResponse: {
11002
10051
  /**
11003
10052
  * @description Health status: healthy or unhealthy
@@ -11483,12 +10532,7 @@ export interface components {
11483
10532
  executionId?: string | null;
11484
10533
  price?: string | null;
11485
10534
  quantity?: string | null;
11486
- /** @description The taker's whole fee on this fill: monacoFee plus builderFee */
11487
10535
  fee?: string | null;
11488
- /** @description The Monaco part of fee */
11489
- monacoFee?: string | null;
11490
- /** @description The builder part of fee */
11491
- builderFee?: string | null;
11492
10536
  };
11493
10537
  /** @description A selected maker's own part of an acceptance, for answering last look. */
11494
10538
  RfqMakerSelection: {
@@ -11504,18 +10548,6 @@ export interface components {
11504
10548
  frozenTerms?: components["schemas"]["RfqQuoteTerms"];
11505
10549
  /** Format: int64 */
11506
10550
  lastLookDeadlineAtMs?: number | null;
11507
- /**
11508
- * Format: int32
11509
- * @description Your Monaco maker fee rate in centi-bps, frozen at acceptance; negative for a rebate
11510
- */
11511
- monacoFeeCbps?: number | null;
11512
- /**
11513
- * Format: int32
11514
- * @description The MOST your frontend's builder add-on charges on this fill, in centi-bps: the rate stored on your quote order. A fill charges this rate or nothing, never more; the receipt shows what was charged. An IMPROVE re-places the quote at the rate configured then. Absent when it could not be read
11515
- */
11516
- maxBuilderFeeCbps?: number | null;
11517
- /** @description Estimated net at the selected quantity and frozen price, in the quote asset, at monacoFeeCbps plus the maximum builder add-on: the least you receive when selling, the most you pay when buying. Absent with maxBuilderFeeCbps */
11518
- estimatedNet?: string | null;
11519
10551
  };
11520
10552
  /** @description A market RFQ is offered on. */
11521
10553
  RfqMarketCapability: {
@@ -11619,14 +10651,6 @@ export interface components {
11619
10651
  vwap?: string | null;
11620
10652
  /** @description Quantity the allocation fills */
11621
10653
  availableQuantity?: string | null;
11622
- /** @description VWAP before fees */
11623
- grossVwap?: string | null;
11624
- /** @description Estimated Monaco taker fee on available_quantity, in the quote asset */
11625
- estimatedMonacoFee?: string | null;
11626
- /** @description Estimated builder fee on available_quantity, in the quote asset */
11627
- estimatedBuilderFee?: string | null;
11628
- /** @description Estimated total taker fee on available_quantity, in the quote asset */
11629
- estimatedTotalFee?: string | null;
11630
10654
  };
11631
10655
  /** @description Authoritative RFQ status. */
11632
10656
  RfqStatus: {
@@ -11666,16 +10690,6 @@ export interface components {
11666
10690
  * @description View time, Unix milliseconds
11667
10691
  */
11668
10692
  asOfMs?: number | null;
11669
- /**
11670
- * Format: int32
11671
- * @description The taker's Monaco fee rate in this view, in centi-bps
11672
- */
11673
- monacoFeeCbps?: number | null;
11674
- /**
11675
- * Format: int32
11676
- * @description The taker's builder fee rate in this view, in centi-bps
11677
- */
11678
- builderFeeCbps?: number | null;
11679
10693
  };
11680
10694
  /**
11681
10695
  * @description One notional bracket of a market's margin ladder. Brackets are MARGINAL:
@@ -12110,10 +11124,7 @@ export interface components {
12110
11124
  * useful for auto-resolved buckets where the caller didn't supply the id.
12111
11125
  */
12112
11126
  marginAccountId?: string | null;
12113
- /**
12114
- * @description The request's strategyKey (the sub-account key) on an isolated risk-bucket
12115
- * preview, `default` when it sent none.
12116
- */
11127
+ /** @description Populated when the simulated account is an auto-resolved bucket. */
12117
11128
  strategyKey?: string | null;
12118
11129
  /** @description Present when the simulation resolved against a risk bucket. */
12119
11130
  riskBucketId?: string | null;
@@ -12214,12 +11225,6 @@ export interface components {
12214
11225
  SimulateRiskBucketOrderRiskRequest: {
12215
11226
  /** Format: uuid */
12216
11227
  tradingPairId?: string | null;
12217
- /**
12218
- * @description Sub-account key of the margin account whose risk bucket this names, like
12219
- * marginAccountId (`default` is the default margin account). Refused when it is
12220
- * not a valid sub-account key, names none of the caller's open sub-accounts, or
12221
- * disagrees with marginAccountId.
12222
- */
12223
11228
  strategyKey?: string | null;
12224
11229
  side?: string | null;
12225
11230
  /** @description Deprecated compatibility value; `side` is authoritative. */
@@ -12465,84 +11470,6 @@ export interface components {
12465
11470
  /** @description When the sweeper last observed progress on the deposit */
12466
11471
  updatedAt?: string | null;
12467
11472
  };
12468
- /** @description What the vault holds of one token. Amounts are raw token units. Withdrawals count when initiated; the vault's physical balance is custodyRaw plus pendingWithdrawalsRaw. Custody is folded from the trade and transfer stream into the aux database while pendingWithdrawalsRaw is read from core, so the two can disagree briefly while the fold lags. */
12469
- TokenCustody: {
12470
- /**
12471
- * Format: uuid
12472
- * @description Asset UUID; null for a token with custody flow but no listed asset
12473
- */
12474
- assetId?: string | null;
12475
- /**
12476
- * @description Asset symbol; null when unlisted
12477
- * @example USDC
12478
- */
12479
- symbol?: string | null;
12480
- /**
12481
- * @description Asset name; null when unlisted
12482
- * @example USD Coin
12483
- */
12484
- name?: string | null;
12485
- /**
12486
- * Format: uint32
12487
- * @description Token decimals; null when unlisted
12488
- * @example 6
12489
- */
12490
- decimals?: number | null;
12491
- /** @description Asset icon URL; null when unlisted */
12492
- iconUrl?: string | null;
12493
- /**
12494
- * @description Token contract address, lowercase
12495
- * @example 0x23e459c24c4925ba89205c400dceca7abc11723d
12496
- */
12497
- contractAddress?: string | null;
12498
- /**
12499
- * @description All-time deposits in raw token units
12500
- * @example 536172601000000
12501
- */
12502
- depositedRaw?: string | null;
12503
- /**
12504
- * @description All-time initiated withdrawals in raw token units
12505
- * @example 1000000
12506
- */
12507
- withdrawnRaw?: string | null;
12508
- /**
12509
- * Format: int64
12510
- * @description Deposits of the token
12511
- * @example 1200
12512
- */
12513
- depositsCount?: number | null;
12514
- /**
12515
- * Format: int64
12516
- * @description Initiated withdrawals of the token
12517
- * @example 310
12518
- */
12519
- withdrawalsCount?: number | null;
12520
- /**
12521
- * @description Deposits less initiated withdrawals in raw token units; null when not positive (never zero: a token held in no amount and one not indexed are different facts)
12522
- * @example 536172600000000
12523
- */
12524
- custodyRaw?: string | null;
12525
- /**
12526
- * @description Withdrawals initiated but not yet executed on-chain, in raw token units; still physically in the vault
12527
- * @example 250000000
12528
- */
12529
- pendingWithdrawalsRaw?: string | null;
12530
- /**
12531
- * @description USD price the custody is valued at: 1 for USDC, null for every other token
12532
- * @example 1
12533
- */
12534
- referencePriceUsd?: string | null;
12535
- /**
12536
- * @description custodyRaw in USD at referencePriceUsd; null without a price or a positive custody
12537
- * @example 536172600
12538
- */
12539
- custodyUsd?: string | null;
12540
- /**
12541
- * @description Whether custodyUsd is summed into tvlUsd (USDC only)
12542
- * @example true
12543
- */
12544
- countsTowardTvl?: boolean | null;
12545
- };
12546
11473
  TpSlLeg: {
12547
11474
  triggerPrice?: string | null;
12548
11475
  orderType?: string | null;
@@ -12725,6 +11652,13 @@ export interface components {
12725
11652
  * @example true
12726
11653
  */
12727
11654
  isActive?: boolean | null;
11655
+ /**
11656
+ * Format: int32
11657
+ * @deprecated
11658
+ * @description DEPRECATED: legacy flat maker fee in bps (negative = rebate). This is the pre-tiered pair-level rate and does NOT reflect the tiered fee actually charged, which is per-user and fractional. Do not display this as the user's fee — call GET /api/v1/fees/tier for the caller's real rate. Will be removed in a later release.
11659
+ * @example -2
11660
+ */
11661
+ makerFeeBps?: number | null;
12728
11662
  /**
12729
11663
  * @description Market type: SPOT or MARGIN
12730
11664
  * @example SPOT
@@ -12772,6 +11706,13 @@ export interface components {
12772
11706
  * @example BTC/USDC
12773
11707
  */
12774
11708
  symbol?: string | null;
11709
+ /**
11710
+ * Format: int32
11711
+ * @deprecated
11712
+ * @description DEPRECATED: legacy flat taker fee in bps. This is the pre-tiered pair-level rate and does NOT reflect the tiered fee actually charged, which is per-user and fractional. Do not display this as the user's fee — call GET /api/v1/fees/tier for the caller's real rate. Will be removed in a later release.
11713
+ * @example 10
11714
+ */
11715
+ takerFeeBps?: number | null;
12775
11716
  /**
12776
11717
  * @description Minimum price increment
12777
11718
  * @example 0.01
@@ -12860,10 +11801,7 @@ export interface components {
12860
11801
  * the parent margin account only.
12861
11802
  */
12862
11803
  tradingPairId?: string | null;
12863
- /**
12864
- * @description Sub-account key of the margin account in the path, if sent: refused when it
12865
- * names another account. Echoed on the response.
12866
- */
11804
+ /** @description Optional strategy key echoed in responses when callers scope a risk bucket. */
12867
11805
  strategyKey?: string | null;
12868
11806
  /**
12869
11807
  * @description Risk bucket mode. Defaults to ISOLATED, which is selected by tradingPairId.
@@ -12889,7 +11827,6 @@ export interface components {
12889
11827
  * zero at the collateral asset's precision.
12890
11828
  */
12891
11829
  newWithdrawableCollateral?: string | null;
12892
- /** @description The request's strategyKey (the sub-account key), echoed. */
12893
11830
  strategyKey?: string | null;
12894
11831
  };
12895
11832
  TransferCollateralFromParentMarginAccountRequest: {
@@ -12938,10 +11875,7 @@ export interface components {
12938
11875
  * the parent margin account only.
12939
11876
  */
12940
11877
  tradingPairId?: string | null;
12941
- /**
12942
- * @description Sub-account key of the margin account in the path, if sent: refused when it
12943
- * names another account. Echoed on the response.
12944
- */
11878
+ /** @description Optional strategy key echoed in responses when callers scope a risk bucket. */
12945
11879
  strategyKey?: string | null;
12946
11880
  /** @description Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer. */
12947
11881
  idempotencyKey?: string | null;
@@ -12961,10 +11895,6 @@ export interface components {
12961
11895
  * zero at the collateral asset's precision.
12962
11896
  */
12963
11897
  newWithdrawableCollateral?: string | null;
12964
- /**
12965
- * @description The request's strategyKey (the sub-account key), echoed; a risk-bucket
12966
- * transfer-in that sent none reports `default`.
12967
- */
12968
11898
  strategyKey?: string | null;
12969
11899
  /** @description Present when collateral was allocated to a risk bucket. */
12970
11900
  riskBucketId?: string | null;
@@ -13002,12 +11932,6 @@ export interface components {
13002
11932
  * Required for isolated risk buckets; omitted for cross risk buckets.
13003
11933
  */
13004
11934
  tradingPairId?: string | null;
13005
- /**
13006
- * @description Sub-account key of the margin account whose risk bucket this names, like
13007
- * marginAccountId (`default` is the default margin account). Refused when it is
13008
- * not a valid sub-account key, names none of the caller's open sub-accounts, or
13009
- * disagrees with marginAccountId.
13010
- */
13011
11935
  strategyKey?: string | null;
13012
11936
  /**
13013
11937
  * @description Risk bucket mode. Defaults to ISOLATED. Values: ISOLATED, CROSS. A CROSS
@@ -13215,7 +12139,7 @@ export interface components {
13215
12139
  * @example false
13216
12140
  */
13217
12141
  useMasterBalance?: boolean | null;
13218
- /** @description The strategyKey the parent was created with (the sub-account key) */
12142
+ /** @description Strategy key used to group risk buckets */
13219
12143
  strategyKey?: string | null;
13220
12144
  /** @description Client-assigned idempotency key */
13221
12145
  clientTwapId?: string | null;
@@ -13653,268 +12577,87 @@ export interface components {
13653
12577
  * @example TAKER
13654
12578
  */
13655
12579
  liquidityRole?: string | null;
12580
+ };
12581
+ VerifyRequest: {
13656
12582
  /**
13657
- * Format: uuid
13658
- * @description The RFQ (block trade) this user's own order filled in; absent on an order-book fill. Read the RFQ with GetRfq.
12583
+ * @description Ethereum wallet address
12584
+ * @example 0x742d35Cc6634C0532925a3b8D4060f31E2C3d8B5
13659
12585
  */
13660
- rfqId?: string | null;
12586
+ address: string;
13661
12587
  /**
13662
- * Format: uuid
13663
- * @description Set on a maker's RFQ fill only: the internal engine id of the quote version the maker's order rested for. It is not the public quoteId.
12588
+ * @description Wallet authorization of the challenge message, hex with an optional 0x prefix. An EOA sends a 65-byte EIP-191 signature; a contract wallet verified under EIP-1271 sends whatever its own contract accepts, which is usually longer and need not be 65 bytes. Capped at 8192 decoded bytes (16386 characters with the prefix) — enough for well over a hundred owner slots — and a longer value is rejected as an invalid signature rather than forwarded to the chain.
12589
+ * @example 0x1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0
13664
12590
  */
13665
- rfqQuoteId?: string | null;
13666
- };
13667
- /** @description One deposit into the vault */
13668
- VaultDeposit: {
12591
+ signature: string;
13669
12592
  /**
13670
- * Format: int64
13671
- * @description The deposit's on-chain index; the feed's order
13672
- * @example 1042
12593
+ * @description Challenge nonce
12594
+ * @example abc123def456
13673
12595
  */
13674
- onChainIndex?: number | null;
12596
+ nonce: string;
13675
12597
  /**
13676
- * @description Deposit transaction hash
13677
- * @example 0x5f2c...
12598
+ * @description Optional application identifier
12599
+ * @example monaco-frontend
13678
12600
  */
13679
- txHash?: string | null;
12601
+ clientId?: string | null;
13680
12602
  /**
13681
- * Format: int64
13682
- * @description Block the deposit landed in
13683
- * @example 18273645
12603
+ * @description Optional chain ID supplied by SDK clients
12604
+ * @example 1328
13684
12605
  */
13685
- blockNumber?: number | null;
12606
+ chainId?: string | null;
13686
12607
  /**
13687
- * @description Token contract address, lowercase
13688
- * @example 0x23e459c24c4925ba89205c400dceca7abc11723d
12608
+ * @description Lowercase hex (64 chars) ed25519 public key generated locally by the SDK. Subsequent authenticated requests are signed with the matching private key. The wallet's signature on the challenge message proves the user authorized this specific public key.
12609
+ * @example 3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29
13689
12610
  */
13690
- token?: string | null;
12611
+ sessionPublicKey: string;
13691
12612
  /**
13692
- * Format: uuid
13693
- * @description Asset UUID, when the token is listed
12613
+ * @description Optional TraderCode captured at signup (e.g. from a `?ref=CODE` link). When a user verifies for the very first time with a valid code, a referral relationship is recorded atomically. Ignored for users who already exist. A code that does not apply (unknown, the wallet's own, or a different referrer than the one the wallet already has) never blocks sign-in; `VerifyResponse.referral_not_applied_reason` says why.
12614
+ * @example 0x1234567890abcdef1234567890abcdef12345678
13694
12615
  */
13695
- assetId?: string | null;
12616
+ referralCode?: string | null;
13696
12617
  /**
13697
- * @description Asset symbol, when the token is listed
13698
- * @example USDC
12618
+ * @description Optional Mainnet invite code. Exactly 10 case-sensitive ASCII letters or digits. Required while Mainnet Invite Mode is enabled for any wallet without a Mainnet access grant, including existing accounts that never received one; ignored while Invite Mode is off and unnecessary once the wallet has access. A missing code is refused with 403 and code INVITE_CODE_REQUIRED; a wrong, redeemed or revoked code, or an unused code whose issuer is deactivated, with 403 and code INVITE_CODE_INVALID. A deactivated signing account is refused with 403 and code ACCOUNT_DEACTIVATED.
12619
+ * @example aB3dE5gH7J
13699
12620
  */
13700
- symbol?: string | null;
12621
+ inviteCode?: string | null;
12622
+ };
12623
+ VerifyResponse: {
13701
12624
  /**
13702
- * @description Amount in raw token units
13703
- * @example 5000000
12625
+ * Format: int32
12626
+ * @description Unix timestamp when the session expires
12627
+ * @example 1699876543
13704
12628
  */
13705
- amountRaw?: string | null;
12629
+ expiresAt?: number | null;
12630
+ user?: components["schemas"]["UserInfo"];
13706
12631
  /**
13707
- * @description Account credited, lowercase
13708
- * @example 0x1234567890abcdef1234567890abcdef12345678
12632
+ * @description True when this verify created the user row — the wallet's first sign-in to THIS application. Identity is per `(wallet, application)`, so a wallet already registered on another application is still `is_new_user` on its first sign-in to a new one. Use it to gate first-time UX (e.g. showing the optional "have a referral code?" input only to new users) and to confirm a fresh sign-up. False for every returning verify on this application.
12633
+ * @example true
13709
12634
  */
13710
- destination?: string | null;
12635
+ isNewUser?: boolean | null;
13711
12636
  /**
13712
- * @description Account type credited
13713
- * @example SPOT
12637
+ * @description True when a TraderCodes referral relationship was recorded on this verify: a valid, non-self TraderCode presented on the wallet's first sign-in to THIS application resolved to a known referrer. Scoped like `is_new_user` (per `(wallet, application)`), so a wallet already registered on another application can still see this on its first sign-in to a new one. False for a returning user of this application, an absent or unknown code, a self-referral, or a wallet that already has a different referrer (see `referral_not_applied_reason`). Confirms the referral landed for the signup success screen.
12638
+ * @example true
13714
12639
  */
13715
- targetAccountType?: string | null;
12640
+ referralApplied?: boolean | null;
13716
12641
  /**
13717
- * Format: int64
13718
- * @description When the deposit was processed, as Unix milliseconds
13719
- * @example 1762041600000
12642
+ * Format: enum
12643
+ * @description Why the TraderCode presented on this sign-up did not apply. Absent when it
12644
+ * applied, when no code was presented, and for a returning user of this
12645
+ * application.
12646
+ * @enum {string|null}
13720
12647
  */
13721
- depositedAt?: number | null;
12648
+ referralNotAppliedReason?: "REFERRAL_NOT_APPLIED_REASON_UNSPECIFIED" | "REFERRAL_NOT_APPLIED_REASON_ALREADY_REFERRED" | "REFERRAL_NOT_APPLIED_REASON_UNKNOWN_CODE" | "REFERRAL_NOT_APPLIED_REASON_SELF_REFERRAL" | null;
12649
+ };
12650
+ WithdrawRfqQuoteRequest: {
13722
12651
  /**
13723
- * @description The displayed builder the deposit came through; null when the builder is
13724
- * hidden or the deposit names none. applications is empty.
12652
+ * Format: int64
12653
+ * @description The caller's current version
13725
12654
  */
13726
- builder?: components["schemas"]["Builder"] | null;
12655
+ expectedVersion: number;
12656
+ idempotencyKey: string;
13727
12657
  };
13728
- /** @description One withdrawal from the vault, from initiation on */
13729
- VaultWithdrawal: {
13730
- /**
13731
- * Format: int64
13732
- * @description Withdrawal index, allocated in request order; the feed's order
13733
- * @example 42
13734
- */
13735
- withdrawalIndex?: number | null;
13736
- /**
13737
- * @description Token contract address, lowercase
13738
- * @example 0x23e459c24c4925ba89205c400dceca7abc11723d
13739
- */
13740
- token?: string | null;
13741
- /**
13742
- * Format: uuid
13743
- * @description Asset UUID, when the token is listed
13744
- */
13745
- assetId?: string | null;
13746
- /**
13747
- * @description Asset symbol, when the token is listed
13748
- * @example USDC
13749
- */
13750
- symbol?: string | null;
13751
- /**
13752
- * @description Amount in raw token units
13753
- * @example 5000000
13754
- */
13755
- amountRaw?: string | null;
13756
- /**
13757
- * @description Address the tokens are paid out to
13758
- * @example 0x1234567890abcdef1234567890abcdef12345678
13759
- */
13760
- destination?: string | null;
13761
- /**
13762
- * @description pending: initiated. confirmed: its proof is ready to execute. executed: paid out on-chain.
13763
- * @example executed
13764
- * @enum {string|null}
13765
- */
13766
- status?: "pending" | "confirmed" | "executed" | null;
13767
- /**
13768
- * Format: int64
13769
- * @description When the withdrawal was initiated, as Unix milliseconds
13770
- * @example 1762041600000
13771
- */
13772
- initiatedAt?: number | null;
13773
- /**
13774
- * @description The displayed builder the withdrawal came through; null when the builder
13775
- * is hidden. applications is empty.
13776
- */
13777
- builder?: components["schemas"]["Builder"] | null;
13778
- };
13779
- VerifyRequest: {
13780
- /**
13781
- * @description Ethereum wallet address
13782
- * @example 0x742d35Cc6634C0532925a3b8D4060f31E2C3d8B5
13783
- */
13784
- address: string;
13785
- /**
13786
- * @description Wallet authorization of the challenge message, hex with an optional 0x prefix. An EOA sends a 65-byte EIP-191 signature; a contract wallet verified under EIP-1271 sends whatever its own contract accepts, which is usually longer and need not be 65 bytes. Capped at 8192 decoded bytes (16386 characters with the prefix) — enough for well over a hundred owner slots — and a longer value is rejected as an invalid signature rather than forwarded to the chain.
13787
- * @example 0x1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0
13788
- */
13789
- signature: string;
13790
- /**
13791
- * @description Challenge nonce
13792
- * @example abc123def456
13793
- */
13794
- nonce: string;
13795
- /**
13796
- * @description Optional application identifier
13797
- * @example monaco-frontend
13798
- */
13799
- clientId?: string | null;
13800
- /**
13801
- * @description Optional EVM chain ID supplied by SDK clients, as a JSON number or a decimal string (for example 1329 or "1329")
13802
- * @example 1328
13803
- */
13804
- chainId?: string | null;
13805
- /**
13806
- * @description Lowercase hex (64 chars) ed25519 public key generated locally by the SDK. Subsequent authenticated requests are signed with the matching private key. The wallet's signature on the challenge message proves the user authorized this specific public key.
13807
- * @example 3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29
13808
- */
13809
- sessionPublicKey: string;
13810
- /**
13811
- * @description Optional TraderCode captured at signup (e.g. from a `?ref=CODE` link). When a user verifies for the very first time with a valid code, a referral relationship is recorded atomically. Ignored for users who already exist. A code that does not apply (unknown, the wallet's own, or a different referrer than the one the wallet already has) never blocks sign-in; `VerifyResponse.referral_not_applied_reason` says why.
13812
- * @example 0x1234567890abcdef1234567890abcdef12345678
13813
- */
13814
- referralCode?: string | null;
13815
- /**
13816
- * @description Optional Mainnet invite code. Exactly 10 case-sensitive ASCII letters or digits. Required while Mainnet Invite Mode is enabled for any wallet without a Mainnet access grant, including existing accounts that never received one; ignored while Invite Mode is off and unnecessary once the wallet has access. A missing code is refused with 403 and code INVITE_CODE_REQUIRED; a wrong, redeemed or revoked code, or an unused code whose issuer is deactivated, with 403 and code INVITE_CODE_INVALID. A deactivated signing account is refused with 403 and code ACCOUNT_DEACTIVATED.
13817
- * @example aB3dE5gH7J
13818
- */
13819
- inviteCode?: string | null;
13820
- };
13821
- VerifyResponse: {
13822
- /**
13823
- * Format: int32
13824
- * @description Unix timestamp when the session expires
13825
- * @example 1699876543
13826
- */
13827
- expiresAt?: number | null;
13828
- user?: components["schemas"]["UserInfo"];
13829
- /**
13830
- * @description True when this verify created the user row — the wallet's first sign-in to THIS application. Identity is per `(wallet, application)`, so a wallet already registered on another application is still `is_new_user` on its first sign-in to a new one. Use it to gate first-time UX (e.g. showing the optional "have a referral code?" input only to new users) and to confirm a fresh sign-up. False for every returning verify on this application.
13831
- * @example true
13832
- */
13833
- isNewUser?: boolean | null;
13834
- /**
13835
- * @description True when a TraderCodes referral relationship was recorded on this verify: a valid, non-self TraderCode presented on the wallet's first sign-in to THIS application resolved to a known referrer. Scoped like `is_new_user` (per `(wallet, application)`), so a wallet already registered on another application can still see this on its first sign-in to a new one. False for a returning user of this application, an absent or unknown code, a self-referral, or a wallet that already has a different referrer (see `referral_not_applied_reason`). Confirms the referral landed for the signup success screen.
13836
- * @example true
13837
- */
13838
- referralApplied?: boolean | null;
13839
- /**
13840
- * Format: enum
13841
- * @description Why the TraderCode presented on this sign-up did not apply. Absent when it
13842
- * applied, when no code was presented, and for a returning user of this
13843
- * application.
13844
- * @enum {string|null}
13845
- */
13846
- referralNotAppliedReason?: "REFERRAL_NOT_APPLIED_REASON_UNSPECIFIED" | "REFERRAL_NOT_APPLIED_REASON_ALREADY_REFERRED" | "REFERRAL_NOT_APPLIED_REASON_UNKNOWN_CODE" | "REFERRAL_NOT_APPLIED_REASON_SELF_REFERRAL" | null;
13847
- };
13848
- /** @description A wallet's figures through one displayed builder. A display group's applications fold into one row under the group. */
13849
- WalletBuilderVolume: {
13850
- /** @description The builder the figures are reported under; applications is empty. */
13851
- builder?: components["schemas"]["Builder"] | null;
13852
- /**
13853
- * @description All-time taker volume in USD through this builder
13854
- * @example 52000
13855
- */
13856
- volumeUsd?: string | null;
13857
- /**
13858
- * Format: int64
13859
- * @description Trades through this builder
13860
- * @example 180
13861
- */
13862
- tradesCount?: number | null;
13863
- /**
13864
- * Format: int64
13865
- * @description First taker trade through this builder as Unix milliseconds
13866
- * @example 1758000000000
13867
- */
13868
- firstTradedAt?: number | null;
13869
- /**
13870
- * Format: int64
13871
- * @description Latest taker trade through this builder as Unix milliseconds
13872
- * @example 1762041600000
13873
- */
13874
- lastTradedAt?: number | null;
13875
- };
13876
- /** @description One wallet's all-time taker figures, every builder included */
13877
- WalletVolume: {
13878
- /**
13879
- * @description Wallet address, lowercase
13880
- * @example 0x1234567890abcdef1234567890abcdef12345678
13881
- */
13882
- wallet?: string | null;
13883
- /**
13884
- * @description All-time taker volume in USD (USDC 1:1)
13885
- * @example 125000.5
13886
- */
13887
- volumeUsd?: string | null;
13888
- /**
13889
- * Format: int64
13890
- * @description Trades the wallet took
13891
- * @example 412
13892
- */
13893
- tradesCount?: number | null;
13894
- /**
13895
- * Format: int64
13896
- * @description The wallet's first taker trade as Unix milliseconds
13897
- * @example 1758000000000
13898
- */
13899
- firstTradedAt?: number | null;
13900
- /**
13901
- * Format: int64
13902
- * @description The wallet's latest taker trade as Unix milliseconds
13903
- * @example 1762041600000
13904
- */
13905
- lastTradedAt?: number | null;
13906
- };
13907
- WithdrawRfqQuoteRequest: {
13908
- /**
13909
- * Format: int64
13910
- * @description The caller's current version
13911
- */
13912
- expectedVersion: number;
13913
- idempotencyKey: string;
13914
- };
13915
- WithdrawRfqQuoteResponse: {
13916
- /** Format: uuid */
13917
- rfqId?: string | null;
12658
+ WithdrawRfqQuoteResponse: {
12659
+ /** Format: uuid */
12660
+ rfqId?: string | null;
13918
12661
  /**
13919
12662
  * Format: int64
13920
12663
  * @description The withdrawal's version
@@ -13935,20 +12678,6 @@ export interface components {
13935
12678
  /** @description 0x-prefixed ABI-encoded executeWithdrawal(...) calldata; submit as tx.data to the vault. Empty on InitiateWithdrawal (the merkle proof is not available until the withdrawal root is confirmed on-chain) — fetch it from GetWithdrawal once ready */
13936
12679
  calldata?: string | null;
13937
12680
  };
13938
- /** @description What the wallet traded through builders the explorer does not display, so the builder rows and the wallet total reconcile */
13939
- WithheldVolume: {
13940
- /**
13941
- * @description Taker volume in USD through hidden builders
13942
- * @example 1500
13943
- */
13944
- volumeUsd?: string | null;
13945
- /**
13946
- * Format: int64
13947
- * @description Trades through hidden builders
13948
- * @example 12
13949
- */
13950
- tradesCount?: number | null;
13951
- };
13952
12681
  };
13953
12682
  responses: never;
13954
12683
  parameters: never;
@@ -14716,795 +13445,7 @@ export interface operations {
14716
13445
  };
14717
13446
  };
14718
13447
  /** @description Authentication required */
14719
- 401: {
14720
- headers: {
14721
- [name: string]: unknown;
14722
- };
14723
- content?: never;
14724
- };
14725
- /** @description Internal server error */
14726
- 500: {
14727
- headers: {
14728
- [name: string]: unknown;
14729
- };
14730
- content?: never;
14731
- };
14732
- };
14733
- };
14734
- set_self_trade_prevention_default: {
14735
- parameters: {
14736
- query?: never;
14737
- header?: never;
14738
- path?: never;
14739
- cookie?: never;
14740
- };
14741
- requestBody: {
14742
- content: {
14743
- "application/json": components["schemas"]["SetSelfTradePreventionDefaultRequest"];
14744
- };
14745
- };
14746
- responses: {
14747
- /** @description OK */
14748
- 200: {
14749
- headers: {
14750
- [name: string]: unknown;
14751
- };
14752
- content: {
14753
- "application/json": components["schemas"]["SelfTradePreventionDefaultResponse"];
14754
- };
14755
- };
14756
- /** @description Unknown mode */
14757
- 400: {
14758
- headers: {
14759
- [name: string]: unknown;
14760
- };
14761
- content?: never;
14762
- };
14763
- /** @description Authentication required */
14764
- 401: {
14765
- headers: {
14766
- [name: string]: unknown;
14767
- };
14768
- content?: never;
14769
- };
14770
- /** @description Delegated-agent sessions cannot change account settings */
14771
- 403: {
14772
- headers: {
14773
- [name: string]: unknown;
14774
- };
14775
- content?: never;
14776
- };
14777
- /** @description Settings write rate limit exceeded — the lead trader profile, follow create/edit and self-trade-prevention default share a per-account budget (and the budget the account family shares); retry after the interval in details.retryAfter */
14778
- 429: {
14779
- headers: {
14780
- [name: string]: unknown;
14781
- };
14782
- content?: never;
14783
- };
14784
- /** @description Internal server error */
14785
- 500: {
14786
- headers: {
14787
- [name: string]: unknown;
14788
- };
14789
- content?: never;
14790
- };
14791
- };
14792
- };
14793
- list_sub_accounts_with_balances: {
14794
- parameters: {
14795
- query?: never;
14796
- header?: never;
14797
- path?: never;
14798
- cookie?: never;
14799
- };
14800
- requestBody?: never;
14801
- responses: {
14802
- /** @description OK */
14803
- 200: {
14804
- headers: {
14805
- [name: string]: unknown;
14806
- };
14807
- content: {
14808
- "application/json": components["schemas"]["ListSubAccountsResponse"];
14809
- };
14810
- };
14811
- /** @description Invalid request */
14812
- 400: {
14813
- headers: {
14814
- [name: string]: unknown;
14815
- };
14816
- content?: never;
14817
- };
14818
- /** @description Authentication required */
14819
- 401: {
14820
- headers: {
14821
- [name: string]: unknown;
14822
- };
14823
- content?: never;
14824
- };
14825
- /** @description Only master accounts can view sub-accounts */
14826
- 403: {
14827
- headers: {
14828
- [name: string]: unknown;
14829
- };
14830
- content?: never;
14831
- };
14832
- /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read budget; retry after the interval in details.retryAfter */
14833
- 429: {
14834
- headers: {
14835
- [name: string]: unknown;
14836
- };
14837
- content?: never;
14838
- };
14839
- /** @description Internal server error */
14840
- 500: {
14841
- headers: {
14842
- [name: string]: unknown;
14843
- };
14844
- content?: never;
14845
- };
14846
- };
14847
- };
14848
- create_sub_account_limit: {
14849
- parameters: {
14850
- query?: never;
14851
- header?: never;
14852
- path?: never;
14853
- cookie?: never;
14854
- };
14855
- requestBody: {
14856
- content: {
14857
- "application/json": components["schemas"]["CreateLimitRequest"];
14858
- };
14859
- };
14860
- responses: {
14861
- /** @description OK */
14862
- 200: {
14863
- headers: {
14864
- [name: string]: unknown;
14865
- };
14866
- content: {
14867
- "application/json": components["schemas"]["CreateLimitResponse"];
14868
- };
14869
- };
14870
- /** @description Limit created successfully */
14871
- 201: {
14872
- headers: {
14873
- [name: string]: unknown;
14874
- };
14875
- content: {
14876
- "application/json": components["schemas"]["CreateLimitResponse"];
14877
- };
14878
- };
14879
- /** @description Invalid request or limit already exists */
14880
- 400: {
14881
- headers: {
14882
- [name: string]: unknown;
14883
- };
14884
- content?: never;
14885
- };
14886
- /** @description Authentication required */
14887
- 401: {
14888
- headers: {
14889
- [name: string]: unknown;
14890
- };
14891
- content?: never;
14892
- };
14893
- /** @description Only master accounts can set sub-account limits */
14894
- 403: {
14895
- headers: {
14896
- [name: string]: unknown;
14897
- };
14898
- content?: never;
14899
- };
14900
- /** @description Sub-account relationship not found or asset not found */
14901
- 404: {
14902
- headers: {
14903
- [name: string]: unknown;
14904
- };
14905
- content?: never;
14906
- };
14907
- /** @description Internal server error */
14908
- 500: {
14909
- headers: {
14910
- [name: string]: unknown;
14911
- };
14912
- content?: never;
14913
- };
14914
- };
14915
- };
14916
- get_sub_account_limits: {
14917
- parameters: {
14918
- query?: never;
14919
- header?: never;
14920
- path: {
14921
- /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
14922
- subAccountId: string;
14923
- };
14924
- cookie?: never;
14925
- };
14926
- requestBody?: never;
14927
- responses: {
14928
- /** @description OK */
14929
- 200: {
14930
- headers: {
14931
- [name: string]: unknown;
14932
- };
14933
- content: {
14934
- "application/json": components["schemas"]["GetLimitsResponse"];
14935
- };
14936
- };
14937
- /** @description Invalid request */
14938
- 400: {
14939
- headers: {
14940
- [name: string]: unknown;
14941
- };
14942
- content?: never;
14943
- };
14944
- /** @description Authentication required */
14945
- 401: {
14946
- headers: {
14947
- [name: string]: unknown;
14948
- };
14949
- content?: never;
14950
- };
14951
- /** @description Sub-account not found */
14952
- 404: {
14953
- headers: {
14954
- [name: string]: unknown;
14955
- };
14956
- content?: never;
14957
- };
14958
- /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read budget; retry after the interval in details.retryAfter */
14959
- 429: {
14960
- headers: {
14961
- [name: string]: unknown;
14962
- };
14963
- content?: never;
14964
- };
14965
- /** @description Internal server error */
14966
- 500: {
14967
- headers: {
14968
- [name: string]: unknown;
14969
- };
14970
- content?: never;
14971
- };
14972
- };
14973
- };
14974
- update_sub_account_limit: {
14975
- parameters: {
14976
- query?: never;
14977
- header?: never;
14978
- path: {
14979
- /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
14980
- subAccountId: string;
14981
- /** @example 1905d968-cc65-4cc7-b77c-1905d968cc65 */
14982
- assetId: string;
14983
- };
14984
- cookie?: never;
14985
- };
14986
- requestBody: {
14987
- content: {
14988
- "application/json": components["schemas"]["UpdateLimitRequest"];
14989
- };
14990
- };
14991
- responses: {
14992
- /** @description OK */
14993
- 200: {
14994
- headers: {
14995
- [name: string]: unknown;
14996
- };
14997
- content: {
14998
- "application/json": components["schemas"]["UpdateLimitResponse"];
14999
- };
15000
- };
15001
- /** @description Invalid request */
15002
- 400: {
15003
- headers: {
15004
- [name: string]: unknown;
15005
- };
15006
- content?: never;
15007
- };
15008
- /** @description Authentication required */
15009
- 401: {
15010
- headers: {
15011
- [name: string]: unknown;
15012
- };
15013
- content?: never;
15014
- };
15015
- /** @description Only master accounts can update sub-account limits */
15016
- 403: {
15017
- headers: {
15018
- [name: string]: unknown;
15019
- };
15020
- content?: never;
15021
- };
15022
- /** @description Limit not found */
15023
- 404: {
15024
- headers: {
15025
- [name: string]: unknown;
15026
- };
15027
- content?: never;
15028
- };
15029
- /** @description Internal server error */
15030
- 500: {
15031
- headers: {
15032
- [name: string]: unknown;
15033
- };
15034
- content?: never;
15035
- };
15036
- };
15037
- };
15038
- delete_sub_account_limit: {
15039
- parameters: {
15040
- query?: {
15041
- /** @description Limit identifier (UUID) */
15042
- limitId?: string;
15043
- };
15044
- header?: never;
15045
- path: {
15046
- /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
15047
- subAccountId: string;
15048
- /** @example 1905d968-cc65-4cc7-b77c-1905d968cc65 */
15049
- assetId: string;
15050
- };
15051
- cookie?: never;
15052
- };
15053
- requestBody?: never;
15054
- responses: {
15055
- /** @description OK */
15056
- 200: {
15057
- headers: {
15058
- [name: string]: unknown;
15059
- };
15060
- content: {
15061
- "application/json": components["schemas"]["DeleteLimitResponse"];
15062
- };
15063
- };
15064
- /** @description Invalid request */
15065
- 400: {
15066
- headers: {
15067
- [name: string]: unknown;
15068
- };
15069
- content?: never;
15070
- };
15071
- /** @description Authentication required */
15072
- 401: {
15073
- headers: {
15074
- [name: string]: unknown;
15075
- };
15076
- content?: never;
15077
- };
15078
- /** @description Only master accounts can delete sub-account limits */
15079
- 403: {
15080
- headers: {
15081
- [name: string]: unknown;
15082
- };
15083
- content?: never;
15084
- };
15085
- /** @description Limit not found */
15086
- 404: {
15087
- headers: {
15088
- [name: string]: unknown;
15089
- };
15090
- content?: never;
15091
- };
15092
- /** @description Internal server error */
15093
- 500: {
15094
- headers: {
15095
- [name: string]: unknown;
15096
- };
15097
- content?: never;
15098
- };
15099
- };
15100
- };
15101
- get_user_trades: {
15102
- parameters: {
15103
- query?: {
15104
- /** @description Items per page (max: 100 in page-number mode; up to 1000 when pageToken is present) */
15105
- pageSize?: number;
15106
- /** @description Trading pair identifier (UUID) */
15107
- tradingPairId?: string;
15108
- /**
15109
- * @description Pagination cursor with two states:
15110
- * - Omitted or empty string (""): start a cursor walk with no prior
15111
- * position, from the newest row.
15112
- * - Non-empty: an opaque cursor from a previous response's
15113
- * `nextPageToken`; results resume immediately after that position.
15114
- *
15115
- * Every walk covers full trade history — hot and archived rows merged. An
15116
- * unfiltered response carries a bounded item count (`total`); a response
15117
- * filtered by `trading_pair_id` carries none. Filters must match the request
15118
- * that produced the token.
15119
- */
15120
- pageToken?: string;
15121
- /**
15122
- * @description Optional margin account UUID filter: only trades where this user's side of
15123
- * the fill was placed from this margin account. A self-trade is read as its
15124
- * maker side, so it matches through its maker order's account. Like
15125
- * `trading_pair_id`, a filtered response carries no `total`, and the filter
15126
- * must match the request that produced a `page_token`.
15127
- */
15128
- marginAccountId?: string;
15129
- /**
15130
- * @description Optional order UUID filter: only trades where this user's side of the
15131
- * fill was placed by this order. A self-trade is read as its maker side, so
15132
- * it matches its maker order only. A filtered response carries no `total`,
15133
- * and the filter must match the request that produced a `page_token`.
15134
- */
15135
- orderId?: string;
15136
- };
15137
- header?: never;
15138
- path?: never;
15139
- cookie?: never;
15140
- };
15141
- requestBody?: never;
15142
- responses: {
15143
- /** @description OK */
15144
- 200: {
15145
- headers: {
15146
- [name: string]: unknown;
15147
- };
15148
- content: {
15149
- "application/json": components["schemas"]["GetUserTradesResponse"];
15150
- };
15151
- };
15152
- /** @description Invalid request */
15153
- 400: {
15154
- headers: {
15155
- [name: string]: unknown;
15156
- };
15157
- content?: never;
15158
- };
15159
- /** @description Authentication required */
15160
- 401: {
15161
- headers: {
15162
- [name: string]: unknown;
15163
- };
15164
- content?: never;
15165
- };
15166
- /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read budget; retry after the interval in details.retryAfter */
15167
- 429: {
15168
- headers: {
15169
- [name: string]: unknown;
15170
- };
15171
- content?: never;
15172
- };
15173
- /** @description Internal server error */
15174
- 500: {
15175
- headers: {
15176
- [name: string]: unknown;
15177
- };
15178
- content?: never;
15179
- };
15180
- };
15181
- };
15182
- list_builder_leaderboard: {
15183
- parameters: {
15184
- query?: {
15185
- /** @description Window: the last 24 hours, 7 days or 30 days before endTime, all time, or custom (startTime to endTime) */
15186
- window?: "24h" | "7d" | "30d" | "all" | "custom";
15187
- /** @description Custom window start as Unix milliseconds. Required with window=custom and rejected otherwise. */
15188
- startTime?: number;
15189
- /** @description Window end as Unix milliseconds; defaults to now. Buckets starting at or before it count. A window counted in hours (2.5 days or shorter) must start within the last 90 days. */
15190
- endTime?: number;
15191
- /** @description Builders to return, largest volume first (max 100) */
15192
- limit?: number;
15193
- };
15194
- header?: never;
15195
- path?: never;
15196
- cookie?: never;
15197
- };
15198
- requestBody?: never;
15199
- responses: {
15200
- /** @description OK */
15201
- 200: {
15202
- headers: {
15203
- [name: string]: unknown;
15204
- };
15205
- content: {
15206
- "application/json": components["schemas"]["ListBuilderLeaderboardResponse"];
15207
- };
15208
- };
15209
- /** @description Invalid window or limit */
15210
- 400: {
15211
- headers: {
15212
- [name: string]: unknown;
15213
- };
15214
- content?: never;
15215
- };
15216
- /** @description Public read rate limit exceeded for this client */
15217
- 429: {
15218
- headers: {
15219
- [name: string]: unknown;
15220
- };
15221
- content?: never;
15222
- };
15223
- /** @description Internal server error */
15224
- 500: {
15225
- headers: {
15226
- [name: string]: unknown;
15227
- };
15228
- content?: never;
15229
- };
15230
- };
15231
- };
15232
- list_builders: {
15233
- parameters: {
15234
- query?: never;
15235
- header?: never;
15236
- path?: never;
15237
- cookie?: never;
15238
- };
15239
- requestBody?: never;
15240
- responses: {
15241
- /** @description OK */
15242
- 200: {
15243
- headers: {
15244
- [name: string]: unknown;
15245
- };
15246
- content: {
15247
- "application/json": components["schemas"]["ListBuildersResponse"];
15248
- };
15249
- };
15250
- /** @description Public read rate limit exceeded for this client */
15251
- 429: {
15252
- headers: {
15253
- [name: string]: unknown;
15254
- };
15255
- content?: never;
15256
- };
15257
- /** @description Internal server error */
15258
- 500: {
15259
- headers: {
15260
- [name: string]: unknown;
15261
- };
15262
- content?: never;
15263
- };
15264
- };
15265
- };
15266
- get_builder: {
15267
- parameters: {
15268
- query?: never;
15269
- header?: never;
15270
- path: {
15271
- /** @example 2fcec460c89c4bedb06781d4072db931 */
15272
- builder: string;
15273
- };
15274
- cookie?: never;
15275
- };
15276
- requestBody?: never;
15277
- responses: {
15278
- /** @description OK */
15279
- 200: {
15280
- headers: {
15281
- [name: string]: unknown;
15282
- };
15283
- content: {
15284
- "application/json": components["schemas"]["GetBuilderResponse"];
15285
- };
15286
- };
15287
- /** @description No displayed builder answers to this key */
15288
- 404: {
15289
- headers: {
15290
- [name: string]: unknown;
15291
- };
15292
- content?: never;
15293
- };
15294
- /** @description Public read rate limit exceeded for this client */
15295
- 429: {
15296
- headers: {
15297
- [name: string]: unknown;
15298
- };
15299
- content?: never;
15300
- };
15301
- /** @description Internal server error */
15302
- 500: {
15303
- headers: {
15304
- [name: string]: unknown;
15305
- };
15306
- content?: never;
15307
- };
15308
- };
15309
- };
15310
- get_builder_series: {
15311
- parameters: {
15312
- query?: {
15313
- /** @description Window: the last 24 hours, 7 days or 30 days before endTime, all time, or custom (startTime to endTime) */
15314
- window?: "24h" | "7d" | "30d" | "all" | "custom";
15315
- /** @description Custom window start as Unix milliseconds. Required with window=custom and rejected otherwise. */
15316
- startTime?: number;
15317
- /** @description Window end as Unix milliseconds; defaults to now. Buckets starting at or before it count. A window counted in hours (2.5 days or shorter) must start within the last 90 days. */
15318
- endTime?: number;
15319
- };
15320
- header?: never;
15321
- path: {
15322
- /** @example 2fcec460c89c4bedb06781d4072db931 */
15323
- builder: string;
15324
- };
15325
- cookie?: never;
15326
- };
15327
- requestBody?: never;
15328
- responses: {
15329
- /** @description OK */
15330
- 200: {
15331
- headers: {
15332
- [name: string]: unknown;
15333
- };
15334
- content: {
15335
- "application/json": components["schemas"]["GetBuilderSeriesResponse"];
15336
- };
15337
- };
15338
- /** @description Invalid window */
15339
- 400: {
15340
- headers: {
15341
- [name: string]: unknown;
15342
- };
15343
- content?: never;
15344
- };
15345
- /** @description No displayed builder answers to this key */
15346
- 404: {
15347
- headers: {
15348
- [name: string]: unknown;
15349
- };
15350
- content?: never;
15351
- };
15352
- /** @description Public read rate limit exceeded for this client */
15353
- 429: {
15354
- headers: {
15355
- [name: string]: unknown;
15356
- };
15357
- content?: never;
15358
- };
15359
- /** @description Internal server error */
15360
- 500: {
15361
- headers: {
15362
- [name: string]: unknown;
15363
- };
15364
- content?: never;
15365
- };
15366
- };
15367
- };
15368
- get_builder_totals: {
15369
- parameters: {
15370
- query?: {
15371
- /** @description Window: the last 24 hours, 7 days or 30 days before endTime, all time, or custom (startTime to endTime) */
15372
- window?: "24h" | "7d" | "30d" | "all" | "custom";
15373
- /** @description Custom window start as Unix milliseconds. Required with window=custom and rejected otherwise. */
15374
- startTime?: number;
15375
- /** @description Window end as Unix milliseconds; defaults to now. Buckets starting at or before it count. A window counted in hours (2.5 days or shorter) must start within the last 90 days. */
15376
- endTime?: number;
15377
- };
15378
- header?: never;
15379
- path: {
15380
- /** @example 2fcec460c89c4bedb06781d4072db931 */
15381
- builder: string;
15382
- };
15383
- cookie?: never;
15384
- };
15385
- requestBody?: never;
15386
- responses: {
15387
- /** @description OK */
15388
- 200: {
15389
- headers: {
15390
- [name: string]: unknown;
15391
- };
15392
- content: {
15393
- "application/json": components["schemas"]["GetBuilderTotalsResponse"];
15394
- };
15395
- };
15396
- /** @description Invalid window */
15397
- 400: {
15398
- headers: {
15399
- [name: string]: unknown;
15400
- };
15401
- content?: never;
15402
- };
15403
- /** @description No displayed builder answers to this key */
15404
- 404: {
15405
- headers: {
15406
- [name: string]: unknown;
15407
- };
15408
- content?: never;
15409
- };
15410
- /** @description Public read rate limit exceeded for this client */
15411
- 429: {
15412
- headers: {
15413
- [name: string]: unknown;
15414
- };
15415
- content?: never;
15416
- };
15417
- /** @description Internal server error */
15418
- 500: {
15419
- headers: {
15420
- [name: string]: unknown;
15421
- };
15422
- content?: never;
15423
- };
15424
- };
15425
- };
15426
- list_vault_deposits: {
15427
- parameters: {
15428
- query?: {
15429
- /** @description Deposits per page (max 1000) */
15430
- pageSize?: number;
15431
- /** @description Opaque keyset cursor from the previous response. */
15432
- pageToken?: string;
15433
- };
15434
- header?: never;
15435
- path?: never;
15436
- cookie?: never;
15437
- };
15438
- requestBody?: never;
15439
- responses: {
15440
- /** @description OK */
15441
- 200: {
15442
- headers: {
15443
- [name: string]: unknown;
15444
- };
15445
- content: {
15446
- "application/json": components["schemas"]["ListVaultDepositsResponse"];
15447
- };
15448
- };
15449
- /** @description Invalid page size or page token */
15450
- 400: {
15451
- headers: {
15452
- [name: string]: unknown;
15453
- };
15454
- content?: never;
15455
- };
15456
- /** @description Public read rate limit exceeded for this client */
15457
- 429: {
15458
- headers: {
15459
- [name: string]: unknown;
15460
- };
15461
- content?: never;
15462
- };
15463
- /** @description Internal server error */
15464
- 500: {
15465
- headers: {
15466
- [name: string]: unknown;
15467
- };
15468
- content?: never;
15469
- };
15470
- };
15471
- };
15472
- list_market_volumes: {
15473
- parameters: {
15474
- query?: {
15475
- /** @description Window: the last 24 hours, 7 days or 30 days before endTime, all time, or custom (startTime to endTime) */
15476
- window?: "24h" | "7d" | "30d" | "all" | "custom";
15477
- /** @description Custom window start as Unix milliseconds. Required with window=custom and rejected otherwise. */
15478
- startTime?: number;
15479
- /** @description Window end as Unix milliseconds; defaults to now. Buckets starting at or before it count. A window counted in hours (2.5 days or shorter) must start within the last 90 days. */
15480
- endTime?: number;
15481
- /** @description Markets to return, largest volume first (max 100) */
15482
- limit?: number;
15483
- };
15484
- header?: never;
15485
- path?: never;
15486
- cookie?: never;
15487
- };
15488
- requestBody?: never;
15489
- responses: {
15490
- /** @description OK */
15491
- 200: {
15492
- headers: {
15493
- [name: string]: unknown;
15494
- };
15495
- content: {
15496
- "application/json": components["schemas"]["ListMarketVolumesResponse"];
15497
- };
15498
- };
15499
- /** @description Invalid window or limit */
15500
- 400: {
15501
- headers: {
15502
- [name: string]: unknown;
15503
- };
15504
- content?: never;
15505
- };
15506
- /** @description Public read rate limit exceeded for this client */
15507
- 429: {
13448
+ 401: {
15508
13449
  headers: {
15509
13450
  [name: string]: unknown;
15510
13451
  };
@@ -15519,21 +13460,18 @@ export interface operations {
15519
13460
  };
15520
13461
  };
15521
13462
  };
15522
- get_protocol_series: {
13463
+ set_self_trade_prevention_default: {
15523
13464
  parameters: {
15524
- query?: {
15525
- /** @description Window: the last 24 hours, 7 days or 30 days before endTime, all time, or custom (startTime to endTime) */
15526
- window?: "24h" | "7d" | "30d" | "all" | "custom";
15527
- /** @description Custom window start as Unix milliseconds. Required with window=custom and rejected otherwise. */
15528
- startTime?: number;
15529
- /** @description Window end as Unix milliseconds; defaults to now. Buckets starting at or before it count. A window counted in hours (2.5 days or shorter) must start within the last 90 days. */
15530
- endTime?: number;
15531
- };
13465
+ query?: never;
15532
13466
  header?: never;
15533
13467
  path?: never;
15534
13468
  cookie?: never;
15535
13469
  };
15536
- requestBody?: never;
13470
+ requestBody: {
13471
+ content: {
13472
+ "application/json": components["schemas"]["SetSelfTradePreventionDefaultRequest"];
13473
+ };
13474
+ };
15537
13475
  responses: {
15538
13476
  /** @description OK */
15539
13477
  200: {
@@ -15541,17 +13479,31 @@ export interface operations {
15541
13479
  [name: string]: unknown;
15542
13480
  };
15543
13481
  content: {
15544
- "application/json": components["schemas"]["GetProtocolSeriesResponse"];
13482
+ "application/json": components["schemas"]["SelfTradePreventionDefaultResponse"];
15545
13483
  };
15546
13484
  };
15547
- /** @description Invalid window */
13485
+ /** @description Unknown mode */
15548
13486
  400: {
15549
13487
  headers: {
15550
13488
  [name: string]: unknown;
15551
13489
  };
15552
13490
  content?: never;
15553
13491
  };
15554
- /** @description Public read rate limit exceeded for this client */
13492
+ /** @description Authentication required */
13493
+ 401: {
13494
+ headers: {
13495
+ [name: string]: unknown;
13496
+ };
13497
+ content?: never;
13498
+ };
13499
+ /** @description Delegated-agent sessions cannot change account settings */
13500
+ 403: {
13501
+ headers: {
13502
+ [name: string]: unknown;
13503
+ };
13504
+ content?: never;
13505
+ };
13506
+ /** @description Settings write rate limit exceeded — the lead trader profile, follow create/edit and self-trade-prevention default share a per-account budget (and the budget the account family shares); retry after the interval in details.retryAfter */
15555
13507
  429: {
15556
13508
  headers: {
15557
13509
  [name: string]: unknown;
@@ -15567,16 +13519,9 @@ export interface operations {
15567
13519
  };
15568
13520
  };
15569
13521
  };
15570
- get_protocol_totals: {
13522
+ list_sub_accounts_with_balances: {
15571
13523
  parameters: {
15572
- query?: {
15573
- /** @description Window: the last 24 hours, 7 days or 30 days before endTime, all time, or custom (startTime to endTime) */
15574
- window?: "24h" | "7d" | "30d" | "all" | "custom";
15575
- /** @description Custom window start as Unix milliseconds. Required with window=custom and rejected otherwise. */
15576
- startTime?: number;
15577
- /** @description Window end as Unix milliseconds; defaults to now. Buckets starting at or before it count. A window counted in hours (2.5 days or shorter) must start within the last 90 days. */
15578
- endTime?: number;
15579
- };
13524
+ query?: never;
15580
13525
  header?: never;
15581
13526
  path?: never;
15582
13527
  cookie?: never;
@@ -15589,17 +13534,31 @@ export interface operations {
15589
13534
  [name: string]: unknown;
15590
13535
  };
15591
13536
  content: {
15592
- "application/json": components["schemas"]["GetProtocolTotalsResponse"];
13537
+ "application/json": components["schemas"]["ListSubAccountsResponse"];
15593
13538
  };
15594
13539
  };
15595
- /** @description Invalid window */
13540
+ /** @description Invalid request */
15596
13541
  400: {
15597
13542
  headers: {
15598
13543
  [name: string]: unknown;
15599
13544
  };
15600
13545
  content?: never;
15601
13546
  };
15602
- /** @description Public read rate limit exceeded for this client */
13547
+ /** @description Authentication required */
13548
+ 401: {
13549
+ headers: {
13550
+ [name: string]: unknown;
13551
+ };
13552
+ content?: never;
13553
+ };
13554
+ /** @description Only master accounts can view sub-accounts */
13555
+ 403: {
13556
+ headers: {
13557
+ [name: string]: unknown;
13558
+ };
13559
+ content?: never;
13560
+ };
13561
+ /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read budget; retry after the interval in details.retryAfter */
15603
13562
  429: {
15604
13563
  headers: {
15605
13564
  [name: string]: unknown;
@@ -15615,14 +13574,18 @@ export interface operations {
15615
13574
  };
15616
13575
  };
15617
13576
  };
15618
- list_token_custody: {
13577
+ create_sub_account_limit: {
15619
13578
  parameters: {
15620
13579
  query?: never;
15621
13580
  header?: never;
15622
13581
  path?: never;
15623
13582
  cookie?: never;
15624
13583
  };
15625
- requestBody?: never;
13584
+ requestBody: {
13585
+ content: {
13586
+ "application/json": components["schemas"]["CreateLimitRequest"];
13587
+ };
13588
+ };
15626
13589
  responses: {
15627
13590
  /** @description OK */
15628
13591
  200: {
@@ -15630,54 +13593,41 @@ export interface operations {
15630
13593
  [name: string]: unknown;
15631
13594
  };
15632
13595
  content: {
15633
- "application/json": components["schemas"]["ListTokenCustodyResponse"];
13596
+ "application/json": components["schemas"]["CreateLimitResponse"];
15634
13597
  };
15635
13598
  };
15636
- /** @description Public read rate limit exceeded for this client */
15637
- 429: {
13599
+ /** @description Limit created successfully */
13600
+ 201: {
15638
13601
  headers: {
15639
13602
  [name: string]: unknown;
15640
13603
  };
15641
- content?: never;
13604
+ content: {
13605
+ "application/json": components["schemas"]["CreateLimitResponse"];
13606
+ };
15642
13607
  };
15643
- /** @description Internal server error */
15644
- 500: {
13608
+ /** @description Invalid request or limit already exists */
13609
+ 400: {
15645
13610
  headers: {
15646
13611
  [name: string]: unknown;
15647
13612
  };
15648
13613
  content?: never;
15649
13614
  };
15650
- };
15651
- };
15652
- get_token_custody: {
15653
- parameters: {
15654
- query?: never;
15655
- header?: never;
15656
- path: {
15657
- token: string;
15658
- };
15659
- cookie?: never;
15660
- };
15661
- requestBody?: never;
15662
- responses: {
15663
- /** @description OK */
15664
- 200: {
13615
+ /** @description Authentication required */
13616
+ 401: {
15665
13617
  headers: {
15666
13618
  [name: string]: unknown;
15667
13619
  };
15668
- content: {
15669
- "application/json": components["schemas"]["GetTokenCustodyResponse"];
15670
- };
13620
+ content?: never;
15671
13621
  };
15672
- /** @description No token answers to this symbol, UUID or address */
15673
- 404: {
13622
+ /** @description Only master accounts can set sub-account limits */
13623
+ 403: {
15674
13624
  headers: {
15675
13625
  [name: string]: unknown;
15676
13626
  };
15677
13627
  content?: never;
15678
13628
  };
15679
- /** @description Public read rate limit exceeded for this client */
15680
- 429: {
13629
+ /** @description Sub-account relationship not found or asset not found */
13630
+ 404: {
15681
13631
  headers: {
15682
13632
  [name: string]: unknown;
15683
13633
  };
@@ -15692,11 +13642,14 @@ export interface operations {
15692
13642
  };
15693
13643
  };
15694
13644
  };
15695
- get_treasury_net_fees: {
13645
+ get_sub_account_limits: {
15696
13646
  parameters: {
15697
13647
  query?: never;
15698
13648
  header?: never;
15699
- path?: never;
13649
+ path: {
13650
+ /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
13651
+ subAccountId: string;
13652
+ };
15700
13653
  cookie?: never;
15701
13654
  };
15702
13655
  requestBody?: never;
@@ -15707,54 +13660,31 @@ export interface operations {
15707
13660
  [name: string]: unknown;
15708
13661
  };
15709
13662
  content: {
15710
- "application/json": components["schemas"]["GetTreasuryNetFeesResponse"];
13663
+ "application/json": components["schemas"]["GetLimitsResponse"];
15711
13664
  };
15712
13665
  };
15713
- /** @description Public read rate limit exceeded for this client */
15714
- 429: {
13666
+ /** @description Invalid request */
13667
+ 400: {
15715
13668
  headers: {
15716
13669
  [name: string]: unknown;
15717
13670
  };
15718
13671
  content?: never;
15719
13672
  };
15720
- /** @description Internal server error */
15721
- 500: {
13673
+ /** @description Authentication required */
13674
+ 401: {
15722
13675
  headers: {
15723
13676
  [name: string]: unknown;
15724
13677
  };
15725
13678
  content?: never;
15726
13679
  };
15727
- };
15728
- };
15729
- list_wallet_leaderboard: {
15730
- parameters: {
15731
- query?: {
15732
- /** @description Wallets to return, largest volume first (max 100) */
15733
- limit?: number;
15734
- };
15735
- header?: never;
15736
- path?: never;
15737
- cookie?: never;
15738
- };
15739
- requestBody?: never;
15740
- responses: {
15741
- /** @description OK */
15742
- 200: {
15743
- headers: {
15744
- [name: string]: unknown;
15745
- };
15746
- content: {
15747
- "application/json": components["schemas"]["ListWalletLeaderboardResponse"];
15748
- };
15749
- };
15750
- /** @description Invalid limit */
15751
- 400: {
13680
+ /** @description Sub-account not found */
13681
+ 404: {
15752
13682
  headers: {
15753
13683
  [name: string]: unknown;
15754
13684
  };
15755
13685
  content?: never;
15756
13686
  };
15757
- /** @description Public read rate limit exceeded for this client */
13687
+ /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read budget; retry after the interval in details.retryAfter */
15758
13688
  429: {
15759
13689
  headers: {
15760
13690
  [name: string]: unknown;
@@ -15770,16 +13700,23 @@ export interface operations {
15770
13700
  };
15771
13701
  };
15772
13702
  };
15773
- get_wallet_summary: {
13703
+ update_sub_account_limit: {
15774
13704
  parameters: {
15775
13705
  query?: never;
15776
13706
  header?: never;
15777
13707
  path: {
15778
- wallet: string;
13708
+ /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
13709
+ subAccountId: string;
13710
+ /** @example 1905d968-cc65-4cc7-b77c-1905d968cc65 */
13711
+ assetId: string;
15779
13712
  };
15780
13713
  cookie?: never;
15781
13714
  };
15782
- requestBody?: never;
13715
+ requestBody: {
13716
+ content: {
13717
+ "application/json": components["schemas"]["UpdateLimitRequest"];
13718
+ };
13719
+ };
15783
13720
  responses: {
15784
13721
  /** @description OK */
15785
13722
  200: {
@@ -15787,18 +13724,32 @@ export interface operations {
15787
13724
  [name: string]: unknown;
15788
13725
  };
15789
13726
  content: {
15790
- "application/json": components["schemas"]["GetWalletSummaryResponse"];
13727
+ "application/json": components["schemas"]["UpdateLimitResponse"];
15791
13728
  };
15792
13729
  };
15793
- /** @description Invalid wallet address */
13730
+ /** @description Invalid request */
15794
13731
  400: {
15795
13732
  headers: {
15796
13733
  [name: string]: unknown;
15797
13734
  };
15798
13735
  content?: never;
15799
13736
  };
15800
- /** @description Public read rate limit exceeded for this client */
15801
- 429: {
13737
+ /** @description Authentication required */
13738
+ 401: {
13739
+ headers: {
13740
+ [name: string]: unknown;
13741
+ };
13742
+ content?: never;
13743
+ };
13744
+ /** @description Only master accounts can update sub-account limits */
13745
+ 403: {
13746
+ headers: {
13747
+ [name: string]: unknown;
13748
+ };
13749
+ content?: never;
13750
+ };
13751
+ /** @description Limit not found */
13752
+ 404: {
15802
13753
  headers: {
15803
13754
  [name: string]: unknown;
15804
13755
  };
@@ -15813,17 +13764,18 @@ export interface operations {
15813
13764
  };
15814
13765
  };
15815
13766
  };
15816
- list_wallet_liquidations: {
13767
+ delete_sub_account_limit: {
15817
13768
  parameters: {
15818
13769
  query?: {
15819
- /** @description Events per page (max 1000) */
15820
- pageSize?: number;
15821
- /** @description Opaque keyset cursor from the previous response, bound to the wallet. */
15822
- pageToken?: string;
13770
+ /** @description Limit identifier (UUID) */
13771
+ limitId?: string;
15823
13772
  };
15824
13773
  header?: never;
15825
13774
  path: {
15826
- wallet: string;
13775
+ /** @example 2b1a5f9c-0000-4000-8000-000000000005 */
13776
+ subAccountId: string;
13777
+ /** @example 1905d968-cc65-4cc7-b77c-1905d968cc65 */
13778
+ assetId: string;
15827
13779
  };
15828
13780
  cookie?: never;
15829
13781
  };
@@ -15835,18 +13787,32 @@ export interface operations {
15835
13787
  [name: string]: unknown;
15836
13788
  };
15837
13789
  content: {
15838
- "application/json": components["schemas"]["ListWalletLiquidationsResponse"];
13790
+ "application/json": components["schemas"]["DeleteLimitResponse"];
15839
13791
  };
15840
13792
  };
15841
- /** @description Invalid wallet address, page size or page token */
13793
+ /** @description Invalid request */
15842
13794
  400: {
15843
13795
  headers: {
15844
13796
  [name: string]: unknown;
15845
13797
  };
15846
13798
  content?: never;
15847
13799
  };
15848
- /** @description Public read rate limit exceeded for this client */
15849
- 429: {
13800
+ /** @description Authentication required */
13801
+ 401: {
13802
+ headers: {
13803
+ [name: string]: unknown;
13804
+ };
13805
+ content?: never;
13806
+ };
13807
+ /** @description Only master accounts can delete sub-account limits */
13808
+ 403: {
13809
+ headers: {
13810
+ [name: string]: unknown;
13811
+ };
13812
+ content?: never;
13813
+ };
13814
+ /** @description Limit not found */
13815
+ 404: {
15850
13816
  headers: {
15851
13817
  [name: string]: unknown;
15852
13818
  };
@@ -15861,13 +13827,41 @@ export interface operations {
15861
13827
  };
15862
13828
  };
15863
13829
  };
15864
- list_vault_withdrawals: {
13830
+ get_user_trades: {
15865
13831
  parameters: {
15866
13832
  query?: {
15867
- /** @description Withdrawals per page (max 1000) */
13833
+ /** @description Items per page (max: 100 in page-number mode; up to 1000 when pageToken is present) */
15868
13834
  pageSize?: number;
15869
- /** @description Opaque keyset cursor from the previous response. */
13835
+ /** @description Trading pair identifier (UUID) */
13836
+ tradingPairId?: string;
13837
+ /**
13838
+ * @description Pagination cursor with two states:
13839
+ * - Omitted or empty string (""): start a cursor walk with no prior
13840
+ * position, from the newest row.
13841
+ * - Non-empty: an opaque cursor from a previous response's
13842
+ * `nextPageToken`; results resume immediately after that position.
13843
+ *
13844
+ * Every walk covers full trade history — hot and archived rows merged. An
13845
+ * unfiltered response carries a bounded item count (`total`); a response
13846
+ * filtered by `trading_pair_id` carries none. Filters must match the request
13847
+ * that produced the token.
13848
+ */
15870
13849
  pageToken?: string;
13850
+ /**
13851
+ * @description Optional margin account UUID filter: only trades where this user's side of
13852
+ * the fill was placed from this margin account. A self-trade is read as its
13853
+ * maker side, so it matches through its maker order's account. Like
13854
+ * `trading_pair_id`, a filtered response carries no `total`, and the filter
13855
+ * must match the request that produced a `page_token`.
13856
+ */
13857
+ marginAccountId?: string;
13858
+ /**
13859
+ * @description Optional order UUID filter: only trades where this user's side of the
13860
+ * fill was placed by this order. A self-trade is read as its maker side, so
13861
+ * it matches its maker order only. A filtered response carries no `total`,
13862
+ * and the filter must match the request that produced a `page_token`.
13863
+ */
13864
+ orderId?: string;
15871
13865
  };
15872
13866
  header?: never;
15873
13867
  path?: never;
@@ -15881,17 +13875,24 @@ export interface operations {
15881
13875
  [name: string]: unknown;
15882
13876
  };
15883
13877
  content: {
15884
- "application/json": components["schemas"]["ListVaultWithdrawalsResponse"];
13878
+ "application/json": components["schemas"]["GetUserTradesResponse"];
15885
13879
  };
15886
13880
  };
15887
- /** @description Invalid page size or page token */
13881
+ /** @description Invalid request */
15888
13882
  400: {
15889
13883
  headers: {
15890
13884
  [name: string]: unknown;
15891
13885
  };
15892
13886
  content?: never;
15893
13887
  };
15894
- /** @description Public read rate limit exceeded for this client */
13888
+ /** @description Authentication required */
13889
+ 401: {
13890
+ headers: {
13891
+ [name: string]: unknown;
13892
+ };
13893
+ content?: never;
13894
+ };
13895
+ /** @description Read rate limit exceeded — every authenticated read draws one request from the account's read budget; retry after the interval in details.retryAfter */
15895
13896
  429: {
15896
13897
  headers: {
15897
13898
  [name: string]: unknown;
@@ -15960,7 +13961,7 @@ export interface operations {
15960
13961
  };
15961
13962
  content?: never;
15962
13963
  };
15963
- /** @description No active, displayed application has this client_id (unknown, inactive and hidden builders read alike) */
13964
+ /** @description No active application has this client_id */
15964
13965
  404: {
15965
13966
  headers: {
15966
13967
  [name: string]: unknown;
@@ -16091,7 +14092,7 @@ export interface operations {
16091
14092
  };
16092
14093
  content?: never;
16093
14094
  };
16094
- /** @description No active, displayed application has this client_id (unknown, inactive and hidden builders read alike) */
14095
+ /** @description No active application has this client_id */
16095
14096
  404: {
16096
14097
  headers: {
16097
14098
  [name: string]: unknown;
@@ -16169,7 +14170,7 @@ export interface operations {
16169
14170
  };
16170
14171
  content?: never;
16171
14172
  };
16172
- /** @description No active, displayed application has this client_id (unknown, inactive and hidden builders read alike) */
14173
+ /** @description No active application has this client_id */
16173
14174
  404: {
16174
14175
  headers: {
16175
14176
  [name: string]: unknown;
@@ -16221,7 +14222,7 @@ export interface operations {
16221
14222
  };
16222
14223
  content?: never;
16223
14224
  };
16224
- /** @description No active, displayed application has this client_id (unknown, inactive and hidden builders read alike) */
14225
+ /** @description No active application has this client_id */
16225
14226
  404: {
16226
14227
  headers: {
16227
14228
  [name: string]: unknown;
@@ -16298,7 +14299,7 @@ export interface operations {
16298
14299
  };
16299
14300
  content?: never;
16300
14301
  };
16301
- /** @description No active, displayed application has this client_id (unknown, inactive and hidden builders read alike) */
14302
+ /** @description No active application has this client_id */
16302
14303
  404: {
16303
14304
  headers: {
16304
14305
  [name: string]: unknown;
@@ -16959,7 +14960,7 @@ export interface operations {
16959
14960
  };
16960
14961
  content?: never;
16961
14962
  };
16962
- /** @description Insufficient BuilderCodes payout balance, including a wallet that never accrued one (gRPC: FAILED_PRECONDITION); or `code: IDEMPOTENCY_KEY_CONFLICT`, the idempotencyKey already names a different request (gRPC: ALREADY_EXISTS) */
14963
+ /** @description Insufficient BuilderCodes payout balance, including a wallet that never accrued one (gRPC: FAILED_PRECONDITION) */
16963
14964
  409: {
16964
14965
  headers: {
16965
14966
  [name: string]: unknown;
@@ -16980,7 +14981,7 @@ export interface operations {
16980
14981
  };
16981
14982
  content?: never;
16982
14983
  };
16983
- /** @description Matching engine unavailable or slow to answer. Outcome UNKNOWN, not a rejection — the claim may still commit. With an idempotencyKey, retry with the same key and request within 15 minutes; `code: ORDER_SUBMISSION_UNAVAILABLE` or `ORDER_SUBMISSION_CAPACITY_EXCEEDED` asks for exactly that. Without one, treat it as pending and do not retry automatically; a balance read does not settle it, because an admitted claim may still be queued. Two tagged cases are the exception, both refused before the claim can be admitted and so provably non-committing, and both safe to retry: a maintenance block (`error: OPERATIONS_BLOCKED`; gRPC metadata `x-maintenance-blocked: true`) and a sequencer overload (`code: OVERLOADED`) (gRPC: UNAVAILABLE) */
14984
+ /** @description Matching engine unavailable or slow to answer. Outcome UNKNOWN, not a rejection — the claim may still commit and there is no idempotency key, so treat it as pending and do not retry automatically; a balance read does not settle it, because an admitted claim may still be queued. Two tagged cases are the exception, both refused before the claim can be admitted and so provably non-committing, and both safe to retry: a maintenance block (`error: OPERATIONS_BLOCKED`; gRPC metadata `x-maintenance-blocked: true`) and a sequencer overload (`code: OVERLOADED`) (gRPC: UNAVAILABLE) */
16984
14985
  503: {
16985
14986
  headers: {
16986
14987
  [name: string]: unknown;
@@ -20289,7 +18290,7 @@ export interface operations {
20289
18290
  get_orderbook_snapshot: {
20290
18291
  parameters: {
20291
18292
  query?: {
20292
- /** @description Number of price levels per side (max 1000). Above 100 the snapshot comes from the market-data book and carries bookSeq */
18293
+ /** @description Number of price levels (max 100) */
20293
18294
  levels?: number;
20294
18295
  /** @description Trading mode */
20295
18296
  tradingMode?: "SPOT" | "MARGIN";
@@ -20316,7 +18317,7 @@ export interface operations {
20316
18317
  "application/json": components["schemas"]["GetOrderbookResponse"];
20317
18318
  };
20318
18319
  };
20319
- /** @description levels outside 1 to 1000, a tradingMode that is invalid or not the pair's, or an invalid magnitude or denomination value */
18320
+ /** @description Invalid magnitude or denomination value */
20320
18321
  400: {
20321
18322
  headers: {
20322
18323
  [name: string]: unknown;
@@ -20330,27 +18331,13 @@ export interface operations {
20330
18331
  };
20331
18332
  content?: never;
20332
18333
  };
20333
- /** @description Deep orderbook read budget exceeded for this client IP on the public ingress (reads above 100 levels cost ceil(levels/100) units; PrivateLink is not metered); retry after the interval in details.retryAfter */
20334
- 429: {
20335
- headers: {
20336
- [name: string]: unknown;
20337
- };
20338
- content?: never;
20339
- };
20340
- /** @description Internal error */
18334
+ /** @description Matching engine not initialized or internal error */
20341
18335
  500: {
20342
18336
  headers: {
20343
18337
  [name: string]: unknown;
20344
18338
  };
20345
18339
  content?: never;
20346
18340
  };
20347
- /** @description The book cannot be read right now: the market-data service above 100 levels, the matching engine at 100 or fewer, or the gateway's matching-engine client is not ready (at any depth); retry */
20348
- 503: {
20349
- headers: {
20350
- [name: string]: unknown;
20351
- };
20352
- content?: never;
20353
- };
20354
18341
  };
20355
18342
  };
20356
18343
  get_orders: {