The account_mptoken_issuances method returns information about MPT issuances created by an account. This method may return large data sets, so you should expect to implement pagination. 
This method is only available using Clio, not xrpld.
{
"command": "account_mptoken_issuances",
"account": "rExB3uFDE92wKYP6vfjt31Lbi6tXpFobUT",
"ledger_index": "validated"
}The request contains the following parameters:
| Field | Type | Required? | Description |
|---|---|---|---|
account | String - Address | Yes | Look up MPT issuances created by this account. |
ledger_index | Ledger Index | No | The Ledger Index of the ledger version to use, or a shortcut string to choose a ledger automatically. See Specifying Ledgers. |
ledger_hash | String | No | A 32-byte hex string for the ledger version to use. See Specifying Ledgers. |
marker | Marker | No | Used to continue your query where it left off in paginating. |
limit | Number (positive integer) | No | Specify a limit to the number of MPT issuances returned. Must be within the inclusive range 10 to 400. Positive values outside this range are replaced with the closest valid option. The default is 200. |
{
"result": {
"account": "rExB3uFDE92wKYP6vfjt31Lbi6tXpFobUT",
"ledger_hash": "F59397558275DF1B9DD3D2430332DB9A58147B102791883D7A6731B3CA5B590C",
"ledger_index": 105505430,
"validated": true,
"limit": 200,
"mpt_issuances": [
{
"mpt_issuance_id": "6F490E070CD43B4FEF94E7334F35A8C263B08D87F4F8413D8E3EA509751DC1F5",
"issuer": "rExB3uFDE92wKYP6vfjt31Lbi6tXpFobUT",
"sequence": 104954046,
"asset_scale": 6,
"maximum_amount": 14300000000000,
"outstanding_amount": 1000000500,
"locked_amount": 500000000,
"mptoken_metadata": "7B226163223A22727761222C226169223A7B226261636B696E67223A22382E344D206F7A204A4F524320696E2D73697475202B207661756C74656420676F6C64222C22696E697469616C5F6E6176223A2231342E334220555344222C22697373756572223A225147502053504320284361796D616E2049736C616E6473205365677265676174656420506F7274666F6C696F20436F6D70616E7929222C226A7572697364696374696F6E223A224361796D616E2049736C616E6473222C22726567697374726174696F6E223A2243522D343136323233222C22726573657276655F6175646974223A224D6F6E74686C79206174746573746174696F6E2C20717561727465726C79204A4F524320757064617465227D2C226173223A22636F6D6D6F64697479222C2264223A22476F6C642D6261636B65642052574120746F6B656E206F6E20585250204C65646765722E204261636B656420627920382E344D206F7A204A4F52432D63657274696669656420696E2D7369747520676F6C6420726573657276657320706C7573207661756C74656420706879736963616C20676F6C642E222C2269223A2268747470733A2F2F7167707370632E636F6D2F76636F72652D69636F6E2E706E67222C22696E223A2251475020535043222C226E223A2256474F4C4420434F52452B222C2274223A2256434F5245222C227573223A5B7B2263223A2277656273697465222C2274223A2256434F5245204F6666696369616C222C2275223A2268747470733A2F2F7167707370632E636F6D2F76636F7265227D2C7B2263223A22646F6373222C2274223A2257686974657061706572222C2275223A2268747470733A2F2F7167707370632E636F6D2F76636F72652D77686974657061706572227D5D7D",
"mpt_can_escrow": true,
"mpt_can_trade": true,
"mpt_can_transfer": true,
"mpt_can_clawback": true
},
{
"mpt_issuance_id": "8F601A25D0DA4308FC69CB844B99B0F7B91EC2563FD00854B5E46C7CA70F5036",
"issuer": "rExB3uFDE92wKYP6vfjt31Lbi6tXpFobUT",
"sequence": 104954064,
"asset_scale": 6,
"maximum_amount": 14300000000000,
"outstanding_amount": 275500000000,
"locked_amount": 220400000000,
"mptoken_metadata": "7B226163223A22727761222C226169223A7B226261636B696E67223A22382E344D206F7A204A4F524320696E2D73697475202B207661756C74656420676F6C64222C22696E697469616C5F6E6176223A2231342E334220555344222C22697373756572223A225147502053504320284361796D616E2049736C616E6473205365677265676174656420506F7274666F6C696F20436F6D70616E7929222C226A7572697364696374696F6E223A224361796D616E2049736C616E6473222C22726567697374726174696F6E223A2243522D343136323233222C22726573657276655F6175646974223A224D6F6E74686C79206174746573746174696F6E2C20717561727465726C79204A4F524320757064617465227D2C226173223A22636F6D6D6F64697479222C2264223A22476F6C642D6261636B65642052574120746F6B656E206F6E20585250204C65646765722E204261636B656420627920382E344D206F7A204A4F52432D63657274696669656420696E2D7369747520676F6C6420726573657276657320706C7573207661756C74656420706879736963616C20676F6C642E222C2269223A2268747470733A2F2F7167707370632E636F6D2F76636F72652D69636F6E2E706E67222C22696E223A2251475020535043222C226E223A2256474F4C4420434F52452B222C2274223A2256434F5245222C227573223A5B7B2263223A2277656273697465222C2274223A2256434F5245204F6666696369616C222C2275223A2268747470733A2F2F7167707370632E636F6D2F76636F7265227D2C7B2263223A22646F6373222C2274223A2257686974657061706572222C2275223A2268747470733A2F2F7167707370632E636F6D2F76636F72652D77686974657061706572227D5D7D",
"mpt_can_escrow": true,
"mpt_can_trade": true,
"mpt_can_transfer": true,
"mpt_can_clawback": true
}
]
},
"id": "example_account_mptoken_issuances",
"status": "success",
"type": "response",
"warnings": [
{
"id": 2001,
"message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
}
]
}The response follows the standard format, with the result containing the following fields:
| Field | Type | Description |
|---|---|---|
account | String | The account whose MPT issuances were queried. |
mpt_issuances | Array | An array of MPT Issuance objects created by the account. |
marker | Marker | Used to continue querying where we left off when paginating. Omitted if there are no more entries after this result. |
limit | Number | The limit, as specified in the request. |
ledger_hash | String | The hash of the ledger version used to generate this response. |
ledger_index | Ledger Index | The index of the ledger version used to generate this response. |
validated | Boolean | If true, the ledger has been validated by the consensus process and is immutable. Otherwise, the contents of the ledger are not final and may change. In Clio, this is always true as Clio stores and returns validated ledger data. |
Each MPT Issuance object has the following fields. Fields marked (May be omitted) are only present when they have a meaningful (non-default) value.
| Field | Type | Description |
|---|---|---|
mpt_issuance_id | String | The MPTokenIssuanceID of this issuance. |
issuer | String | The account that created this issuance. |
sequence | Number | The sequence number of the transaction that created this issuance. |
transfer_fee | Number | (May be omitted) The fee charged, in units of 1/100,000, when tokens of this issuance are transferred between non-issuer accounts. Omitted if the issuance charges no transfer fee. |
asset_scale | Number | (May be omitted) The number of decimal places used to represent amounts of this token. |
maximum_amount | Number | (May be omitted) The maximum number of tokens that can be issued for this MPTokenIssuance. |
outstanding_amount | Number | (May be omitted) The number of tokens of this issuance currently held by all holders. |
locked_amount | Number | (May be omitted) The number of tokens of this issuance currently held in escrow. |
mptoken_metadata | String | (May be omitted) Arbitrary metadata about this issuance, in hexadecimal. |
domain_id | String | (May be omitted) The PermissionedDomainID associated with this issuance, if any. |
mpt_locked | Boolean | (May be omitted) All balances of this issuance are frozen by the issuer. This is unrelated to locked_amount. |
mpt_can_lock | Boolean | (May be omitted) The issuer can freeze individual balances or the entire issuance. |
mpt_require_auth | Boolean | (May be omitted) Individual holders must be authorized by the issuer before they can hold this token. |
mpt_can_escrow | Boolean | (May be omitted) Holders can place balances of this token into escrow. |
mpt_can_trade | Boolean | (May be omitted) Holders can trade balances of this token on the decentralized exchange. (Requires the MPTokensV2 amendment. ) |
mpt_can_transfer | Boolean | (May be omitted) Tokens of this issuance can be transferred between non-issuer accounts. |
mpt_can_clawback | Boolean | (May be omitted) The issuer can claw back tokens of this issuance from holders. |
- Any of the universal error types.
invalidParams- One or more fields are specified incorrectly, or one or more required fields are missing.actMalformed- The Address specified in theaccountfield of the request is not a valid account address.actNotFound- The Address specified in theaccountfield of the request does not correspond to an account in the ledger.lgrNotFound- The ledger specified by theledger_hashorledger_indexdoes not exist, or the server does not have it.