# Near

<details>

<summary>Supported Mainnnet Tokens for Portfolio Endpoint</summary>

1. Name: **SWEAT** \
   Address: token.sweat
2. Name: **Aurora** \
   Address: aaaaaa20d9e0e2461697782ef11675f668207961.factory.bridge.near
3. Name: **USN** \
   Address: usn
4. Name: **Realis** \
   Address: token.v1.realisnetwork.near
5. Name: **LiNEAR** \
   Address: linear-protocol.near
6. Name: **USD Coin** \
   Address: a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.factory.bridge.near
7. Name: **Tether USD** \
   Address: usdt.tether-token.near
8. Name: **Wrapped NEAR fungible token** \
   Address: wrap.near
9. Name: **Ref Finance Token** \
   Address: token.v2.ref-finance.near
10. Name: **Tether USD** \
    Address: dac17f958d2ee523a2206206994597c13d831ec7.factory.bridge.near
11. Name: **Staked NEAR** \
    Address: meta-pool.near
12. Name: **Ether** \
    Address: aurora
13. Name: **Octopus Network Token** \
    Address: f5cfbc74057c610c8ef151a439252680ac68c6dc.factory.bridge.near
14. Name: **Dai Stablecoin** \
    Address: 6b175474e89094c44da98b954eedeac495271d0f.factory.bridge.near
15. Name: **Wrapped BTC** \
    Address: 2260fac5e5542a773aa44fbcfedf7c193bc2c599.factory.bridge.near
16. Name: **Meta Token** \
    Address: meta-token.near
17. Name: **Aurigami Token** \
    Address: 1ab43204a195a0fd37edec621482afd3792ef90b.factory.bridge.near
18. Name: **Pulse** \
    Address: 52a047ee205701895ee06a375492490ec9c597ce.factory.bridge.near
19. Name: **PembRock** \
    Address: token.pembrock.near
20. Name: **SeatlabNFT** \
    Address: token.stlb.near
21. Name: **Burrow Token** \
    Address: token.burrow\.near
22. Name: **Wootrade Network** \
    Address: 4691937a7508860f876c9c0a2a617e7d9e945d4b.factory.bridge.near
23. Name: **HAPI** \
    Address: d9c2d319cd7e6177336b0a9c93c21cb48d84fb54.factory.bridge.near
24. Name: **PARAS** \
    Address: token.paras.near
25. Name: **Skyward Finance Token** \
    Address: token.skyward.near
26. Name: **NearPad Token** \
    Address: ea7cc765ebc94c4805e3bff28d7e4ae48d06468a.factory.bridge.near
27. Name: **Flux Token** \
    Address: 3ea8ea4237344c9931214796d9417af1a1180770.factory.bridge.near
28. Name: **YouMinter** \
    Address: e99de844ef3ef72806cf006224ef3b813e82662f.factory.bridge.near
29. Name: **Frax Share** \
    Address: 3432b6a60d23ca0dfca7761b7ab56459d9c964d0.factory.bridge.near
30. Name: **NEKO** \
    Address: ftv2.nekotoken.near
31. Name: **ABR** \
    Address: abr.a11bd.near
32. Name: **Bastion** \
    Address: 059a1f1dea1020297588c316ffc30a58a1a0d4a2.factory.bridge.near
33. Name: **Celo** \
    Address: celo.token.a11bd.near
34. Name: **Stader** \
    Address: 30d20208d987713f46dfd34ef128bb16c404d10f.factory.bridge.near
35. Name: **Wrapped Ether** \
    Address: c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.factory.bridge.near
36. Name: **1MILNFT** \
    Address: a4ef4b0b23c1fc81d3f9ecf93510e64f58a4a016.factory.bridge.near
37. Name: **Solana** \
    Address: sol.token.a11bd.near
38. Name: **marma j token** \
    Address: marmaj.tkn.near
39. Name: **Chronicle** \
    Address: 06a00715e6f92210af9d7680b584931faf71a833.factory.bridge.near
40. Name: **Huobi BTC** \
    Address: 0316eb71485b0ab14103307bf65a021042c6d380.factory.bridge.near
41. Name: **Frax** \
    Address: 853d955acef822db058eb8505911ed77f175b99e.factory.bridge.near
42. Name: **BlocksquareToken** \
    Address: 509a38b7a1cc0dcd83aa9d06214663d9ec7c7f4a.factory.bridge.near
43. Name: **DODO bird** \
    Address: 43dfc4159d86f3a37a5a4b3d4580b888ad7d4ddd.factory.bridge.near
44. Name: **Celo Dollar** \
    Address: cusd.token.a11bd.near
45. Name: **Basic Attention Token** \
    Address: 0d8775f648430679a709e98d2b0cb6250d2887ef.factory.bridge.near
46. Name: **CRO** \
    Address: a0b73e1ff0b80914ab6fe0444e65848c4c34450b.factory.bridge.near
47. Name: **Crafting Finance** \
    Address: 508df5aa4746be37b5b6a69684dfd8bdc322219d.factory.bridge.near
48. Name: **moda** \
    Address: 1117ac6ad6cdf1a3bc543bad3b133724620522d5.factory.bridge.near
49. Name: **Uniswap**\
    Address: 1f9840a85d5af5bf1d1762f925bdaddc4201f984.factory.bridge.near
50. Name: **Scamfari** \
    Address: 8353b92201f19b4812eee32efd325f7ede123718.factory.bridge.near

</details>

### /getbalance

Get the balance or number of the given token in the requested public address.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/getbalance`

#### Query Parameters

| Name                                        | Type   | Description                                                                          |
| ------------------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| rpc                                         | String | Remote procedural call URL                                                           |
| chainId<mark style="color:red;">\*</mark>   | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| chainSymbol                                 | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| address<mark style="color:red;">\*</mark>   | String | The public address to get the balance of.                                            |
| tokenAddress                                | String | The address of token to get the balance of.                                          |
| networkId<mark style="color:red;">\*</mark> | String | Contains the network Id (testnet or mainnet).                                        |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/getbalance/?address=app.nearcrowd.near&chainId=1200
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": "276604143416550089062799879"
    }
}
```

{% endtab %}
{% endtabs %}

### /getblock

Get details of a block.

<mark style="color:blue;">`GET`</mark> `https://historicallp.api.expand.network/chain/getblock`

#### Query Parameters

| Name                                          | Type   | Description                                                                          |
| --------------------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| rpc                                           | String | Remote procedural call URL.                                                          |
| chainId<mark style="color:red;">\*</mark>     | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| chainSymbol                                   | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| blockNumber<mark style="color:red;">\*</mark> | String | The block number or block hash.                                                      |
| networkId                                     | String | Contains the network Id (testnet or mainnet).                                        |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://historicallp.api.expand.network/chain/getblock?blockNumber=48208733&chainId=1200
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "difficulty": null,
        "gasLimit": null,
        "gasUsed": "100000000",
        "hash": "EH2EUAcfQuVtwgjbSy1cYSWxTqnuoE6hB7Qs3yUkwtTi",
        "miner": null,
        "nonce": null,
        "number": "48208733",
        "parentHash": "A4DPUSm6WCm34LTRLHrmVdVDobC37PjHqACd2srWGXeQ",
        "size": null,
        "timestamp": 1632130984114315800,
        "totalDifficulty": null,
        "transactions": [
            {
                "balance_burnt": "4794491933184300000000",
                "chunk_hash": "J4SbJiazEWAHnNLHTEq6FvCQbfNP2zoQjeUXDhJ7sDPz",
                "encoded_length": 3630,
                "encoded_merkle_root": "CegYTGt7DA7RTmAAvH7Vr4ZLdzocMXN4AYzZPmcp7P1m",
                "gas_limit": 1000000000000000,
                "gas_used": 64561954584952,
                "height_created": 48208733,
                "height_included": 48208733,
                "outcome_root": "81Ces8UVPcU2KqHJs3Pa3vJWgHZDyh8stsUfrPYRY3jo",
                "outgoing_receipts_root": "Fq3y8c1vT5E6erZL6VwNegmcbXMUsozfychmFDhiHpie",
                "prev_block_hash": "A4DPUSm6WCm34LTRLHrmVdVDobC37PjHqACd2srWGXeQ",
                "prev_state_root": "2MLkUCQj4sHVGuVTqwKgTh47Q1fsGSXBc2RSopEUzFx2",
                "rent_paid": "0",
                "shard_id": 0,
                "signature": "ed25519:35FPeXGCemZeajdr1D99LGFAibHZNpGQY5LPt5N3aAYxT3xqZyTSJ6S8CxTvRqxMBGnrDz7WALVLcksmdjkrHNvh",
                "tx_root": "6RyWHXk3ygrJTWUvF1BC955Fo2oC1HXKZJKp6daXFSes",
                "validator_proposals": [],
                "validator_reward": "0"
            }
        ],
        "transactionsRoot": "HDgRo5ZfnEW49HbYK6FrVzovDKvxDnexTvsNHmKtkXT2",
        "uncles": null
    }
}
```

{% endtab %}
{% endtabs %}

### /gettransaction

Get details of a transaction.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/gettransaction`

#### Query Parameters

| Name                                              | Type   | Description                                                                          |
| ------------------------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| rpc                                               | String | Remote procedural call URL.                                                          |
| chainId<mark style="color:red;">\*</mark>         | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| chainSymbol                                       | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| transactionHash<mark style="color:red;">\*</mark> | String | The transaction Hash.                                                                |
| networkId<mark style="color:red;">\*</mark>       | String | Contains the network Id (testnet or mainnet).                                        |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/gettransaction?chainId=1200&transactionHash=28CYUY3Jcmjjy19rx5x4GUp7kWKSuxgTuzsnm6WbjqgR
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "hash": "28CYUY3Jcmjjy19rx5x4GUp7kWKSuxgTuzsnm6WbjqgR",
        "blockNumber": "D2rC8zK6JkFDXuewMH3g15S71whhjJ6arr6ATHLXGQUF",
        "timestamp": null,
        "from": "app.nearcrowd.near",
        "to": "app.nearcrowd.near",
        "value": null,
        "transactionFees": 2428517994378,
        "gas": null,
        "gasPrice": null,
        "input": [
            {
                "FunctionCall": {
                    "args": "eyJ0YXNrX29yZGluYWwiOjEsImlzX2hvbmV5cG90IjpmYWxzZSwiaG9uZXlwb3RfcHJlaW1hZ2UiOlsxMDQsOTksMTAzLDExMCwxMTMsMTA4LDExMiwxMTEsMTA4LDExOCwxMDYsOTgsMTE5LDExNSwxMjEsMTE5XSwidGFza19wcmVpbWFnZSI6WzcwLDU3LDIwMSwxMjQsMTE0LDI0NSwxMjQsMTk1LDE5MiwxOTYsMzAsMjM5LDIyMCw0NywxODgsNTQsMTIxLDk1LDM2LDIxMywxNzEsMTI5LDEwMCw1MSwxODMsNjQsMjgsMTI2LDExNSwxMjEsMjQxLDEzNl19",
                    "deposit": "0",
                    "gas": 200000000000000,
                    "method_name": "challenge"
                }
            }
        ],
        "network": null
    }
}
```

{% endtab %}
{% endtabs %}

### /portfolio

Get the comprehensive information about the assets/ tokens owned by a user.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/portfolio`

#### Query Parameters

| Name                                      | Type    | Description                                                                          |
| ----------------------------------------- | ------- | ------------------------------------------------------------------------------------ |
| rpc                                       | String  | Remote procedural call URL.                                                          |
| chainId                                   | String  | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| chainSymbol                               | String  | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| address<mark style="color:red;">\*</mark> | String  | Public addess of the user.                                                           |
| tokens                                    | String  | Comma-separated value of tokens to get value of. Maximum 10 at a time.               |
| availableOnly                             | Boolean | <p>By default, true. <br>If true, tokens with balance > 0 will be listed.</p>        |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/portfolio?chainId=1200&address=spin.sweat&availableOnly=true
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "native": "657102532292146469652654940",
        "nep141": [
            {
                "name": "SWEAT",
                "symbol": "SWEAT",
                "address": "token.sweat",
                "balance": "4478246379997954161168780",
                "USDPrice": "0.009696888755975658"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

### **/**&#x67;etstakepositions

This endpoint retrieves information about staked native asset positions for a specified address, including the total staked amount across all validators as well as the individual positions staked with each validator.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/chain/getstakepositions`

#### Query Parameters

<table><thead><tr><th width="180">Name</th><th width="99">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>chainId<mark style="color:red;">*</mark></td><td>String</td><td>Refer to the <a href="../../../ids/chain-ids">Chain ID </a>page for details.</td></tr><tr><td>chainSymbol</td><td>String</td><td>Refer to the <a href="../../../ids/chain-ids">Chain ID </a>page for details.</td></tr><tr><td>address<mark style="color:red;">*</mark></td><td>String</td><td>Public addess of the user.</td></tr><tr><td>validatorAddress</td><td>String</td><td>Address of Validator</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/chain/getstakepositions?address=5d405172e96927a7a6de6ec95c3879345a47b3c0cf6d97653d76c61f5c1262b9&chainId=1200&validatorAddress=astro-stakers.poolv1.near
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "activeStake": "2.902585808691909e+25",
        "stakePositions": [
            {
                "stake": "2.902585808691909e+25",
                "staker": "5d405172e96927a7a6de6ec95c3879345a47b3c0cf6d97653d76c61f5c1262b9",
                "withdrawer": "5d405172e96927a7a6de6ec95c3879345a47b3c0cf6d97653d76c61f5c1262b9",
                "validator": "astro-stakers.poolv1.near"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

### **/sendtransaction**

Send transaction on the chain.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/chain/sendtransaction`

#### Request Body

| Name                                             | Type    | Description                                                                          |
| ------------------------------------------------ | ------- | ------------------------------------------------------------------------------------ |
| chainId<mark style="color:red;">\*</mark>        | Integer | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| chainSymbol                                      | String  | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| rawTransaction<mark style="color:red;">\*</mark> | String  | The encoded transaction, obtained from signed transaction.                           |
| rpc                                              | String  | Remote procedural call URL.                                                          |

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "chainId": "1200",
    "rawTransaction": "FAAAAG1hZGh1dXV1dXV1ci50ZXN0bmV0AEkY3+wQ0vYMKdwUWiNMqpXqdeiHfeC+xzYEoSqBUbe8TokHDDheAAAUAAAAbXl0ZXN0bWFkaHVyLnRlc3RuZXQgoucUF/0pEF1+QF3rfhesMNR8DoSo9kOwUtA8jxglZgEAAAADAABAvYtbk2tsAAAAAAAAAADmi3KGo3Rw3x4pIwf/oub5d1VdfIcrgeEOgOBRs9qnXm3zZ4UQzheNJZ3om271QiMXw0hK/lFQMEWtKGOK8Z0A"
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1200",
        "transactionHash": "FVgzzKafnM8FT6y3r86s2nDCyYbiqkEsFrZ6371b3uxs"
    }
}
```

{% endtab %}
{% endtabs %}

### /decodetransaction

Get the decoded transaction for the provided raw transaction.&#x20;

<mark style="color:green;">`POST`</mark> `https://api.expand.network/chain/decodetransaction`

#### Request Body

| Name                                             | Type   | Description                                                                                                |
| ------------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------- |
| chainId<mark style="color:red;">\*</mark>        | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. By default, Ethereum. |
| chainSymbol                                      | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details.                       |
| rawTransaction<mark style="color:red;">\*</mark> | String | The raw transaction to be given for decoding.                                                              |

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "chainId": "1200",
    "rawTransaction": "EQAAAGhrMTY0NjQ1NS50ZXN0bmV0AI5NZ/HOf9Z3lhnFXWzGKLlpQquoZ0koM9NwA6pyady3wVPUJFiBAAARAAAAaGsxNjQ2NDU1LnRlc3RuZXRRcSU8anY2BbU3Hdp6nFc800OP06VcXt9Y6zi7bNKS6wEAAAADAADoiQQjx4oAAAAAAAAAAACFkU6wouNgPzyGby4Ab7qs8YLUuTmgLVoihNVoUp/pNTyZT/5TC6ozr2tAIfbMxmrAEzqpxqZFEgd/p0U+zfoC"
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "parsedTx": {
            "transaction": {
                "signerId": "hk1646455.testnet",
                "publicKey": {
                    "keyType": 0,
                    "data": {
                        "0": 142,
                        "1": 77,
                        "2": 103,
                        "3": 241,
                        "4": 206,
                        "5": 127,
                        "6": 214,
                        "7": 119,
                        "8": 150,
                        "9": 25,
                        "10": 197,
                        "11": 93,
                        "12": 108,
                        "13": 198,
                        "14": 40,
                        "15": 185,
                        "16": 105,
                        "17": 66,
                        "18": 171,
                        "19": 168,
                        "20": 103,
                        "21": 73,
                        "22": 40,
                        "23": 51,
                        "24": 211,
                        "25": 112,
                        "26": 3,
                        "27": 170,
                        "28": 114,
                        "29": 105,
                        "30": 220,
                        "31": 183
                    }
                },
                "nonce": "815824d453c1",
                "receiverId": "hk1646455.testnet",
                "blockHash": {
                    "0": 81,
                    "1": 113,
                    "2": 37,
                    "3": 60,
                    "4": 106,
                    "5": 118,
                    "6": 54,
                    "7": 5,
                    "8": 181,
                    "9": 55,
                    "10": 29,
                    "11": 218,
                    "12": 122,
                    "13": 156,
                    "14": 87,
                    "15": 60,
                    "16": 211,
                    "17": 67,
                    "18": 143,
                    "19": 211,
                    "20": 165,
                    "21": 92,
                    "22": 94,
                    "23": 223,
                    "24": 88,
                    "25": 235,
                    "26": 56,
                    "27": 187,
                    "28": 108,
                    "29": 210,
                    "30": 146,
                    "31": 235
                },
                "actions": [
                    {
                        "transfer": {
                            "deposit": "8ac7230489e80000"
                        },
                        "enum": "transfer"
                    }
                ]
            },
            "signature": {
                "keyType": 0,
                "data": {
                    "0": 133,
                    "1": 145,
                    "2": 78,
                    "3": 176,
                    "4": 162,
                    "5": 227,
                    "6": 96,
                    "7": 63,
                    "8": 60,
                    "9": 134,
                    "10": 111,
                    "11": 46,
                    "12": 0,
                    "13": 111,
                    "14": 186,
                    "15": 172,
                    "16": 241,
                    "17": 130,
                    "18": 212,
                    "19": 185,
                    "20": 57,
                    "21": 160,
                    "22": 45,
                    "23": 90,
                    "24": 34,
                    "25": 132,
                    "26": 213,
                    "27": 104,
                    "28": 82,
                    "29": 159,
                    "30": 233,
                    "31": 53,
                    "32": 60,
                    "33": 153,
                    "34": 79,
                    "35": 254,
                    "36": 83,
                    "37": 11,
                    "38": 170,
                    "39": 51,
                    "40": 175,
                    "41": 107,
                    "42": 64,
                    "43": 33,
                    "44": 246,
                    "45": 204,
                    "46": 198,
                    "47": 106,
                    "48": 192,
                    "49": 19,
                    "50": 58,
                    "51": 169,
                    "52": 198,
                    "53": 166,
                    "54": 69,
                    "55": 18,
                    "56": 7,
                    "57": 127,
                    "58": 167,
                    "59": 69,
                    "60": 62,
                    "61": 205,
                    "62": 250,
                    "63": 2
                }
            }
        }
    }
}
```

{% endtab %}
{% endtabs %}